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PREFACE 


This document is published as part of the UNIX Operating System Program Generic, 
PG-1C300 Issue 2. The development of the Program Generic is the result of the 
efforts of the members of the UNIX Support Group, supervised by J. F. Maranzano 
and composed of: R. B. Brandt, J. Feder, C. D. Perez, T. M. Raleigh, R. E. Swift, G. 
C. Vogel and I. A. Winheim. 


Most of the commands and system software were written by the Computing Science 
Research Center (127), especially K. Thompson and D. M. Ritchie. Contributions 
have also been made by members of the Computer Planning Department (8234), the 
Support Products and Systems Department (9152), and the Switching Maintenance 
and Administration Laboratory (522). 


This manual is based on documentation by K. Thompson and D. Ritchie. These 
pages were phototypeset in the Murray Hill Computation Center, with the cooperation 
of J. Sturman, the guidance of V. B. Turner and the editing assistance of G. Pettit. 


For corrections and comments please contact C. D. Perez, MH 2C-423, Extension 
6041. 
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INTRODUCTION TO THIS MANUAL 


This manual gives descriptions of the publicly available features of UNIX. It provides neither a 
general overview — see ‘‘The UNIX Time-sharing System’? (Comm. ACM 17 7, July 1974, pp. 
365-375) for that — nor details of the implementation of the system, which remain to be dis- 
closed. | 


Within the area it surveys, this manual attempts to be as complete and timely as possible. A 
conscious decision was made to describe each program in exactly the state it was in at the time 
its manual section was prepared. In particular, the desire to describe something as it should be, 
not as it is, was resisted. Inevitably, this means that many sections will soon be out of date. 


This manual is divided into eight sections: 


I. Commands 

II. System Calls 
ITI. Subroutines 
IV. Drivers 

V. File Formats 
VI. User Programs 
VII. Tables 


VIII. System Programs 


Commands are programs intended to be invoked directly by the user, in contradistinction to 
subroutines, which are intended to be called by the user’s programs. Commands generally re- 
side in directory /bin (for binary programs). Some programs also reside in /usr/bin, to save 
space in /bin. These directories are searched automatically by the command interpreter. 


System calls are entries into the UNIX supervisor. In assembly language, they are coded with 
the use of the opcode sys, a synonym for the trap instruction. In this edition, the C language 
interface routines to the system calls have been incorporated in section II. 


A small assortment of subroutines is available; they are described in section III. The binary 
form of most of them is kept in the system library //ib/liba.a. The subroutines available from C 
and from Fortran are also included; they reside in //ib/libc.a and /lib/libf/.a respectively. 


Drivers (section IV) discusses the characteristics of each system ‘‘file’’ which actually refers to 
an I/O device. The names in this section refer to the DEC device names for the hardware, in- 
stead of the names of the special files themselves. 


File Formats (section V)documents the structure of particular kinds of files; for example, the 
form of the output of the loader and assembler is given. Excluded are files used by only one 
command, for example the assembler’s intermediate files. 


User Programs (section VI), while part of the Standard UNIX system, are not fully supported, 
and the principal reason for listing them is to indicate their existence without necessarily giving 
a complete description. 
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Section VII groups together the information pertaining to tabular data. 


Section VIII discusses commands which are not intended for use by the ordinary user, in some 
cases because they disclose information in which he is presumably not interested, and in others 
because they perform privileged functions. 


Each section consists of a number of independent entries of one or more pages. Below the pro- 
gram application heading is the name of the entry in bold-face type. Entries within each section 
are alphabetized. The page numbers of each entry start at 1. 


All entries are based on a common format, not all of whose subsections will always appear. 


The name section repeats the entry name and gives a very short description of its pur- 
pose. 


The sjvopsis summarizes the use of the program being described. A few conventions 
are used, particularly in the Commands section: 


Boldface words are considered literals, and are typed just as they appear. 


Square brackets ( [ ] ) around an argument indicate that the argument is op- 
ional. When an argument is given as ‘‘name’”’, it always refers to a file name. 


Ellipses **...’’ are used to show that the previous argument-prototype may be 
repeated. 


A final convention is used by the commands themselves. An argument begin- 
ning with a minus sign ‘*‘—’’ is often taken to mean some sort of flag argument 
even if it appears in a position where a file name could appear. Therefore, it 1s 


,9 


unwise to have files whose names begin with ‘*— 
The description section discusses in detail the subject at hand. 
The /fi/es section gives the names of files which are built into the program. 
A see also Section gives pointers to related information. 


A diagnostics section discusses the diagnostic indications which may be produced. Mes- 
sages which are intended to be self-explanatory are not listed. 


The bugs section gives known bugs and sometimes deficiencies. Occasionally also the 
Suggested fix is described. 


At the beginning of this document is a table of contents, organized by section and alphabetically 
within each section. There is also a permuted index derived from the table of contents. Within 
each index entry, the title of the writeup to which it refers is followed by the appropriate section 
number in parentheses. This fact is important because there is considerable name duplication 
among the sections, arising principally from commands which exist only to exercise a particular 
system call. 


This manual was prepared using the UNIX text editor ed and the formatting program @roff. 
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HOW TO GET STARTED 


This section provides the basic information you need to get started on UNIX: how to log in and 
log out, how to communicate through your terminal, and how to run a program. See ‘‘ UNIX 
for Beginners’’ by Brian W. Kernighan for a more complete introduction to the system. 


Logging in. You must call UNIX from an appropriate terminal. UNIX Supports ASCII terminals 
typified by the Try 37, the GE Terminet 300, the Dasi 300, and various graphical terminals. 
You must also have a valid user name, which may be obtained, together with the telephone 
number, from the system administrators. The same telephone number serves terminals operat- 
ing at all the standard speeds. After a data connection is established, the login procedure 
depends on what kind of terminal you are using. 


300-baud terminals: Such terminals include the GE Terminet 300, most display termi- 
nals, Execuport, TI, GSI, and certain Anderson-Jacobson terminals. These terminals 
generally have a speed switch which should be set at ‘‘300” (or ‘‘30°° for 30 characters 
per second) and a half/full duplex switch which should be set at full-duplex. (This 
switch will often have to be changed since many other systems require haif-cupiex:. 
When a connection is established, the system types ‘‘login:’’; you type your user name, 
followed by the ‘‘return’’ key. If you have a password, the system asks for it and turns 
off the printer on the terminal so the password will not appear. After you have logged 
in, the ‘‘return’’, “‘new line’’, or ‘‘linefeed’’ keys will give exactly the same results. 


TTY 37 terminal: When you have established a data connection, the system types out a 
few garbage characters (the ‘‘login:’’ message at the wrong speed). Depress the 
‘‘break’’ (or ‘‘interrupt’’) key; this is a speed-independent signal to UNIX that a 150- 
baud terminal is in use. The system then will type ‘“‘login:,’’ this time at the correc: 
speed; you respond with your user name. From the TTy 37 terminal, and any other 
which has the ‘‘new-line’’ function (combined carriage return and linefeed), terminate 
each line you type with the ‘‘new-line’’ key (nor the ‘‘return”’ key). 


For all these terminals, it is important that you type your name in lower-case if possible; if vou 
type upper-case letters, UNIX will assume that your terminal cannot generate lower-case letters 
and will translate all subsequent upper-case letters to lower case. 


The evidence that you have successfully logged in is that the Shell program will type a ‘*%”” to 
_ you. (The Shell is described below under ‘‘How to run a program.’’) 


For more information, consult gefty (VIII), which discusses the login sequence in more detail, 
tty (IV), which discusses typewriter I/O, and &/ (IV) ,which discusses the console typewriter. 


Logging out. There are three ways to log out: 
You can simply hang up the phone. 


You can log out by typing an end-of-file indication (EOT character, control ‘‘d’’) to the 
Shell. The Shell will terminate and the ‘‘login: >> message will appear again. 


You can also log in directly as another user by giving a /ogi command (1). 
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How to communicate through your terminal. When you type to UNIX, the characters are collected 
and saved by the system. The characters will not be given to a program until you type a return 
(or new-line), as described above in Logging in. 


UNIX typewriter I/O is full-duplex. It has full read-ahead, which means that you can type at any 
time, even while a program is typing at you. Of course, if you type during output, the output 
will have the input characters interspersed. However, whatever you type will be saved up and 
interpreted in correct sequence. There is a limit to the amount of read-ahead, but it is gen- 
erous and not likely to be exceeded unless the system is in trouble. When the read-ahead limit 
is exceeded, the system throws away all the saved characters. 


On a typewriter input line, the character *‘@’° kills all the characters typed before it, so typing 
mistakes can be repaired on a single line. Also, the character ‘‘#’” erases the last character 
typed. Successive uses of ‘‘#°” erase characters back to, but not beyond, the beginning of the 
line. ‘‘@** and ‘‘#*° can be transmitted to a program by preceding them with ‘‘\’’. (So, to 
erase **\’’, you need two *‘#°'s). 


The ascil ‘‘delete’’ (a.k.a. “‘rubout’’) character is not passed to programs but instead generates 
an wuerrupt signal. This signal generally causes whatever program you are running to terminate. 
It is typically used to stop a long printout that you don’t want. However, programs can arrange 
either to ignore this signal altogether, or to be notified when it happens (instead of being ter- 
minated). The editor, for example, catches interrupts and stops what it is doing, instead of ter- 
minating, so that an interrupt can be used to halt an editor printout without losing the file being 
edited. 


The gu signal is generated by typing the ASCII FS character. It not only causes a running pro- 
gram to terminate but also generates a file with the core image of the terminated process. Quit 
is useful for debugging. 


Besides adapting to the speed of the terminal, UNIX tries to be intelligent about whether you 
have a terminal with the new-line function or whether it must be simulated with carriage-return 
and line-feed. In the latter case, all input carriage returns are turned to new-line characters (the 
standard line delimiter) and both a carriage return and a line feed are echoed to the terminal. 
If you get into the wrong mode, the s/t) command (1) will rescue you. 


Tab characters are used freely in UNIX Source programs. If your terminal does not have the tab 
function, you can arrange to have them turned into spaces during output, and echoed as spaces 
during input. The system assumes that tabs are set every eight columns. Again, the sly com- 
mand (1) will set or reset this mode. Also, there is a file which, if printed on TTY 37 or Ter- 
miNet 300 terminals, will set the tab stops correctly (tabs (VII)). 


How to run a program; the Shell. When you have successfully logged into UNIX, a program 
called the Shell is listening to your terminal. The Shell reads typed-in lines, splits them up into 
a command name and arguments, and executes the command. A command is simply an exe- 
cutable program. The Shell looks first in your current directory (see next section) for a pro- 
gram with the given name, and if none is there, then in a system directory. There is nothing 
special about system-provided commands except that they are kept in a directory wherc the 
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Shell can find them. 


The command name is always the first word on an input line; it and its arguments are separated 
from one another by spaces. 


When a program terminates, the Shell will ordinarily regain control and type a ‘*%°” at you to 
indicate that it is ready for another command. 


The Shell has many other capabilities, which are described in detail in section s/ (1). 


The current directory. UNIX has a file system arranged in a hierarchy of directories. When the 
system administrator gave you a user name, he also created a directory for you (ordinarily with 
the same name as your user name). When you log in, any file name vou type is by default in 
this directory. Since you are the owner of this directory, you have full permissions to read, 
write, alter, or destroy its contents. Permissions to have your will with other directories and 
files will have been granted or denied to you by their owners. As a matter of observed fact, few 
UNIX users protect their files from destruction, let alone perusal, by other users. 


To change the current directory (but not the set of permissions you were endowed with at lo- 
gin) use chdir (J). | 


Path names. To refer to files not in the current directory, you must use a path name. Full 
path names begin with ‘‘/**, the name of the root directory of the whole file system. After the 
slash comes the name of each directory containing the next sub-directory (followed by a ‘‘/”*) 
until finally the file name is reached. E.g.: /usr/lem/filex refers to the file fi/ex in the directory 
lem; femvis itself a Subdirectors of usr: sr springs directly from the root directory. 


If your current directory has subdirectories, the path names of files therein begin with the name 
of the subdirectory (no prefixed **/"*). 


Without important exception, a path name may be used anywhere a file name is required. 


Important commands which modify the contents of files are cp (1). mv (1), and rm (1), which 
respectively copy. move (i.e. rename) and remove files. To find out the status of files or direc- 
tories, use /s (1). See mAdir (1) for making directories; raid (1) tor destroying them. 


For a fuller discussion of the file system. see ‘*The UNIX Time-Sharing System,” by K. Thomp- 
son and D. M. Ritchic. Jt may also be usefui to glance through section I] of this manual, which 
discusses system calls, even if you don’t intend to deal with the system at that level. 


Writing a program. To enter the text of a source program into a UNIX file, use ed (1). The 
three principal languages in UNIX are assembly language (see vs (1)), Fortran (see fc (1)), and C 
(see cc (I). After the program text has been entered through the editor and written on a file, 
you can give the file to the appropriate language processor as an argument. The output of the 
language processor will be left on a file in the current directory named “‘a.out’’. (If the output 
is precious, use my to move it to a less exposed name soon.) Tf you wrote in assembly 
language, you will probably need to load the program with library subroutines, see // (1). The 
other two language processors call the loader automatically. 


When you have finally gone through this entire process without provoking any diagnostics, the 


Bell Telephone Laboratories, Incorporated -9- PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION | | Section 1 
Issue 1, January 1976 

AT&TCo SPCS 


resulting program can be run by giving its name to the Shell in response to the ‘‘%”” prompt. 


The next command you will need is db (I). As a debugger, </b is better than average for 
assembly-language programs, marginally useful for C programs and virtually useless for Fortran. 


Your programs can receive arguments from the command line just as system programs do. See 
exec (II). 


Text processing. Almost all text is entered through the editor. The commands most often used 
to write text on a terminal are: cal, pr, and nroff, all in section I. 


The cat command simply dumps ASCII text on the terminal, with no processing at all. The pr 
command paginates the text, supplies headings, and has a facility for multi-column output. 
Nroff is an elaborate text formatting program, and requires careful forethought in entering both 
the text and the formatting commands into the input file. Nroff produces output on a typewriter 
terminal. 


Surprises. Certain commands provide inter-user communication. Even if you do not plan to 
use them, it would be well to learn something about them, because someone else may aim 
them at you. 


To communicate with another user currently logged in, wriue (1) is used; mai (1) will leave a 
message whose presence will be announced to another user when he next logs in. The write- 
ups in the manual also suggest how to respond to the two commands if you are a target. 


When you log in, a message-of-the-day may greet you before the first ““%"*. The System Ad- 
ministrator, wishing to send a message-of-the-day, puts his data into /etc/motd, where it will be 
used as a general announcement each time someone logs on, until the message is erased from 
the file. 
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end, etext, edata 

EXp «ww as 
floor, ceil oe eee 
fmod 

fptrap 

gamma tn ee es 
getarg, largc 

getc, getw, fopen 
getchar 

getpw 

hmul 

hypot 

lerror 

Idiv, Ilrem 

locv 

log 

ltod 

mesg at es 
mktemp 

monitor 

nargs 

nlist 

- perror, sys_errlist, sys_ne 
pow ... 

printf ....... 
putc, putw, fcreat, fflush 
putchar, flush 

qsort wa 

rand, srand 

reset, setexit 

set fil ; 

sin, Cos oe wats ee 
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generate an IOT fault 

absolute value 

core allocator 

arc tangent function 

convert ASCII to floating 

: convert ASCII to integer 

default comparison routine for qsort 

password encoding 

Be feed ree convert date and time to ASCII 
floating point to double precision integer conversion 
Output conversion 

last locations in program 

exponential function 

floor and ceiling functions 

floating modulo function 

floating point interpreter 

log gamma function 

get command arguments from Fortran 

buffered input 

read character 

get name from UID 

high-order product 

calculate hypotenuse 

catch Fortran errors 

long division 

long Output conversion 

a ee ee ae ee natural logarithm 
double precision integer to floating point conversion 
write message on typewriter 

make a unique named temporary file 

prepare execution profile 

argument count 

get entries from name list 

rr, errno Say ae ee ene system error messages 
floating exponentiation 

formatted print 

buffered output 

write character 

quicker sort 

random number generator 

execute non-local goto 

specify Fortran file name 

a ee trigonometric functions 
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IV. DRIVERS 


GC: Ah ace ow Be te 
dh ee ee ee 
GN: <e- Ne ew Belk ee 
GD & we we ee 
Np: @ ere he ee ee 


mem, kmem, null > das eS 
DG. a -e. t e. a es ee ee ee 
4 Ss eb ee oe ee 
1, ee 8 oe, Se Ses 2 
BD! xe i Oe Ea ote ee, Se 
CC): cae See AU ee et Se ce a a ee 
EIU * | qh nue et ige “lat be See Jer Se eos 


Uo 6 oe ee iow A 


V. FILE FORMATS 


AOU 4:6 Aa eee eS 
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Sah A ik We-lenae Be Re square root function 
dees return name of current typewriter 


oe ee DC-11 communications interface 
ae DH-11 communications multiplexer 
intestate Hodes Se, DN-11 ACU interface 
Scie: as at DP-11 201 data-phone interface 
gh see Sa da we RH-11/RP04 moving-head disk 
as RH11/RS03-RS04 fixed-head disk file 
ae ae RH-11/TU-16 magtape interface 
. .  KL-11 or DL-11 asynchronous interface 
oe tes gs te ee eS line printer 
sD aks See eave gt Ae te ats en 25. Be ee core memory 
Be ade eae PC-11 paper tape reader/punch 
@ we. ee £73 RF11/RS11 fixed-head disk file 
sa a es Ga? at RK-11/RK03 (or RKOS) disk 
Rene Gece RP-11/RP03 moving-head disk 
de iid. ogy ok th aac TC-11/TUS6 DECtape 
Stk oe ae TM-11/TU-10 magtape interface 
es, teense So i general typewriter interface 


oA assembler and link editor output 
ae ee we hy oe, 8 archive (library) file format 
Bue Ae ae We format of core image file 
ee ae ee ae ee format of directories 
scien Bist te incremental dump tape format 
a the cee es te Me format of file system volume 
ieee Ses. de GG RE aie rst ee ee password file 
a ee ee DEC/mag tape formats 
See: ah Was be typewriter initialization data 
ir as eee ek ee ee ee user information 
ge te ads Cau, os Me. Oe gs et He user login history 


Bs Migs 1 generate associative memory drivers 
ee ee ae ee the game of black jack 
at 4 Sh 86 Sse sh ae “A aie es ee print calendar 
Ge, Ab Se te Ge i we at the game of chess 
Rott lay at 8. see oe three dimensional tic-tac-toe 
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fACtOk. gk cS EH, HE . . . . . discover prime factors of a number 
fed edit form letter memory 
form Se vgn sas. Sab tah, eon a> ed ee ee form letter generator 
gsi ; . » . interpret extended character set on GSI terminal 
hyphen ......2... i a Ee es Be EE St find hyphenated words 
lex generate programs for simple lexical tasks 
moo guessing game 
ptx permuted index 
sno Snobol interpreter 
tmac macros for formatting manuscripts 
ttt the game of tic-tac-toe 
wump the game of hunt-the-wumpus 
VII. TABLES 

ascii : map of ASCII character set 
greek shies for extended TTY-37 type-box 
mtab mounted file system table 
tabs set tab stops 


VII. SYSTEM PROGRAMS 


ac 


boot procedures 


Be, aE ah dg? Sud ee abe wer ey, Ge. Bee a EA ae login accounting 
UNIX startup 
file system consistency check 


check 

chown change owner 
clri a Me wa ao clear 1-node 
crash what to do when the system crashes 
df : : disk free 
dump green file system dump 
getty set typewriter mode 
glob & otk generate command arguments 
icheck file system consistency check and interactive repair 
init process control initialization 
ino get the i-number of a file 
Ipd line printer daemon 
mkfs construct a file system 
mknod build special file 
mount mount file system 
reloc : relocate object files 
restor incremental file system restore 
Sa Shell accounting 
Su become privileged user 
sync update the super block 
umount dismount file system 


update 


seeks update the super block 
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PERMUTED INDEX 


dp(IV) DP-11 


abs, fabs(III) 
ac(VIII) login 
sa(VIII) Shell 
alarm (II) 
dn(IV) DN-11 


shift (I) 
alarm(II) activate 


break, brk, sbrk (II) change core 
alloc(III) core 


yacc(I) yet 
write(I) write to 


be (I) 

atan, atan2 (III) 

ar (1) 

ar(V) 

nargs(III) 

getarg, iargc(III) get command 
echo(1) echo 

glob(VII]) generate command 
shift(I1) adjust Shell 


ascii(VII) map of 
atof(III) convert 
atoi(III) convert 
gmtime(III) convert date and time to 


a.out(V) 

as (1) 

agen(VI) generate 
kKI(/V) KL-11 or DL-11 


atan, 


201 data-phone interface 

abort(III) generate an IOT fault 
abs, fabs(III) absolute value 
absolute value 

accounting 

accounting 

activate alarm clock timer 

ACU interface 

ac(VIII) login accounting 

adjust Shell arguments 

agen(VI) generate associative memory drivers 
alarm clock timer 

alarm(II) activate alarm clock timer 
allocation 

allocator 

alloc(III) core allocator 

another compiler-compiler 

another user 

a.out(V) assembler and link editor output 
arbitrary precision interactive language 
arc tangent function 

archive and library maintainer 
archive (library) file format 
argument count 

arguments from Fortran 

arguments 

arguments 

arguments 

ar(1) archive and library maintainer 
ar(V) archive (library) file format 
ASCII character set 

ASCII to floating 

ASCII to integer 

ASCII...ctime, localtime, 

ascii(VII) map of ASCII character set 
as(1) assembler 

assembler and link editor output 
assembler 

associative Memory drivers 
asynchronous interface 

atan, atan2(III) arc tangent function 
atan2(III) arc tangent function 
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wait (I) 
bas (1) 


su(VIII) 
strip(1) remove symbols and relocation 


bj(VI) the game of 
sync(VIII) update the super 
update(VIII) periodically update the super 


break, 

getc, getw, fopen(III) 

putc, putw, fcreat, flush (III) 
mknod( VIII) 

ce(1) 

cdb(I) 

hypot (III) 

dc(1) desk 

cal(V]) print 

indir (II) indirect system 
intro(II) introduction to system 


ierror (III) 
signal (II) 


floor, 

floor, ceil(II1) floor and 
break, brk, sbrk (11) 
passwd (1) 

chmod (II) 

chmod (1) 

chown (11) 

chown( VIII) 

chdir (1) 

chdir (II) 

pipe (II) create an interprocess 
gsi(V1) interpret extended 
ascii(VII) map of ASCII 
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atof(III) convert ASCII to floating 
atoi(III) convert ASCII to integer 
await completion of process 

bas(I) basic 

basic 

bc(I) arbitrary precision interactive language 
become privileged user 

bits 

bj(VI) the game. of black jack 
black jack 

block 

block 

boot procedures(VIJI]) UNIX startup 
break, brk, sbrk (II) change core allocation 
brk, sbrk(I]) change core allocation 
buffered input 

buffered output 

build special file 

C compiler 

C debugger 

calculate hypotenuse 

calculator 

calendar 

call 

calls 

cal(VI) print calendar 

catch Fortran errors 

catch or ignore signals 

cat(1) concatenate and print 

cc(1) C compiler 

cdb(1) C debugger 

ceil(III) floor and ceiling functions 
ceiling functions 

change core allocation 

change login password 

change mode of file 

change mode 

change owner and group of a file 
change owner 

change working directory 

change working directory 

channel 

character set on GSI terminal 
character set | 
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getchar(III) read 
putchar, flush(III) write 


icheck(VIII) file system consistency 
check(VIII) file system consistency 


chess(VI) the game of 


clri(VIID 
alarm(II) activate alarm 
close (II) 


getarg, iargc(III) get 

glob(VIII) generate 

nice(I) run a 

exit(I) terminate 

specify interrupt processing for a 
nohup(I) run a 

sh(1) shell 

goto(I) 

if(I) conditional 

time(1) time a 


comm(I) print lines 
dc(IV) DC-11 
dh(IV) DH-11 
diff(I) differential file 
cmp(I) 


compar (III) default 
cc(I) C 

yacc(I) yet another 
fc(I) Fortran 

IcQ) LIL 

wait(I) await 

cat (I) 

if (I) 
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character 


chdir(I) change working directory 
chdir(II) change working directory 
check and interactive repastr 

check 

check(VIII) file system consistency check 
chess 

chess(VI) the game of chess 
chmod(I) change mode 

chmod (II) change mode of file 
chown(II) change owner and group of a file 
chown(VIII) change owner 

clear i-node 

clock timer 

close a file 

close(II) close a file 

clri(VIII) clear i-node 

cmp(I) compare two files 
command arguments from Fortran 
command arguments 

command at low priority 
command file 

command file...onintr(1) 

command immune to hangups 
(command interpreter) 

command transfer 

command 

command 

comm(I) print lines common to two files 
common to twe files 
communications interface 
communications multiplexer 


- comparator 


compare two files 

compar (III) default comparison routine for qsort 
comparison routine for qsort 

compiler 

compiler-compiler 

compiler 

compiler 

completion of process 

concatenate and print 


conditional command 
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icheck(VIII) file system 

check(VIII) file system 

csw(II) read 

mkfs(VIID 

Is(I) list 

init(VIII) process 

floating point to double precision integer 
ecvt, fevt(III) output 

locv(III) long output 

double precision integer to floating point 
dd(I) 

atof (III) 

atoi (III) 

ctime, localtime, gmtime (III) 

dd(I) convert and 

cp(I) 

break, brk, sbrk(II) change 

alloc (Il) 

core(V) format of 

mem, kmem, null(IV) 


sin, 
nargs(III) argument 
wce(I) word 


crash(VIII) what to do when the system 


creat (II) 
pipe (II) 


cref(I) make 


ASCII... 


ttyn (III) return name of 

dpd(VIII) data phone 

Ipd(VIII) line printer 

dp(lv) DP-11 201 

prof(I) display profile 

ttys(V) typewriter initialization 
ctime, localtime, gmtime(III) convert 
time(II) get 


consistency check and interactive repair 
consistency check 

console switches 

construct a file system 

contents of directory 

control initialization 
conversion...dtol (III) 

conversion 

conversion 

conversion...ltod (III) 

convert and copy a file 

convert ASCII to floating 
convert ASCII to integer 

convert date and time to ASCII 
copy a file 

copy 

core allocation 

core allocator 

core image file 

core memory 

core(V) format of core image file 
cos(IIl) trigonometric functions 
count 

count 

cp(1) copy 

crashes 

crash(VIII) what to do when the system crashes 
create a new file 

create an interprocess channel 
creat(II) create a new file 

cref(1) make cross reference listing 
cross reference listing 

crypt(III) password encoding 
csw(II) read console switches 


ctime, localtime, gmtime(III) convert date and time to 


cubic(VI) three dimensional tic-tac-toe 
current typewriter 

daemon 

daemon . 

data-phone interface 

data 

data 

date and time to ASCII 

date and time 
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- mdate(II) set modified 
date(I) print and set the 


| — de(IV) 


db(I). 


—edb(I) C 

a> ¢ tp(V) 

_ tp(1) manipulate 
tc(IV) TC-11/TUS6 
compar (III) 

dsw(I) 

mesg(I) permit or 
dup(II) duplicate an open file 
mail(1) send mail to 
dc(I) 

file (I) 


‘dh(Iv) 


diff(1) 


cubic(VI) three 

dir(V) format of 

unlink (II) remove 
pwd(I) working 

mknod (II) make a 
chdir(I) change working 
chdir(II) change working 
Is(I) list contents of 
mkdir(I) make a 
rmdir(I) remove 


| factor(VI)_ 


hs(IV) RH11/RS03-RS04 fixed-head 
rf(IV) RF11/RS11 fixed-head 
df(VII1) 


du(I) summarize 


hp(IV) RH-11/RP04 moving-head 
rk (IV) RK-11/RK03 (or RKOS) 
rp(IV) RP-11/RP03 moving-head 
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date on file 

date | | a 

date(I) print and set the date 
db(I) debug 

DC-11 communications interface 
dc(I) desk calculator 

dc(IV) DC-11 communications interface 
dd(I) convert and copy a file 
debug. : 

debugger | 

-DEC/mag tape formats 

DECtape and magtape 

DECtape 

default comparison routine for qsort 
, delete interactively 

deny messages 

descriptor 

designated users 

desk calculator 

determine format of file 

df(VIII) disk free 

DH-11 communications multiplexer 
dh(IV) DH-11 communications multiplexer 
differential file comparator 

diff(1) differential file comparator 
dimensional tic-tac-toe 

directories 

directory entry 

directory name 

directory or a special file 

directory 

directory 

directory 

directory 

directory 

dir(V) format of directories 
discover prime factors of a number 
disk file 

disk file 

disk free 

disk usage 

disk 

disk 

disk 
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umount(II) 
umount(VIII) 
prof(I) 

Idiv, Irem(III) long 
kI(IV) KL-11 or 
dn(IV) 


dtol (III) floating point to 
Itod (III) 
dp(IV) 


agen(VI) generate associative memory 
conversion... 


dump(V) incremental 
dump(VIII) incremental file system 
od(I) octal 


dup (II) 
echo(I) 


end, etext, 


fed(V1) 

a.out(V) assembler and link 
ed(I) text 

Id (1) link 

crypt(III) password 


nlist (III) get 

unlink (II) remove directory 
perror, sys_errlist, sys_nerr, 
sys nerr, errno(III) system 
ierror(III) catch Fortran 

| end, 

pfe(1) print floating 


| exec, 
exec, execl, execv (II) 


oe) ee 
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dismount file system 

dismount file system 

display profile data 

division 

DL-1! asynchronous interface 

DN-11 ACU interface 

dn(IV) DN-11 ACU interface 

double precision integer conversion 
double precision integer to floating point conversion 
DP-11 201 data-phone interface 
dpd(VIII) data phone daemon 

dp(IV) DP-11 201 data-phone interface 
drivers 

dsw(I) delete interactively 

dtol (III) floating point to double precision integer 
du(I) summarize disk usage 

dump tape format 

dump 

dump 

dump(V) incremental dump tape format 
dump(VIII) incremental file system dump 
dup(II) duplicate an open file descriptor 
duplicate an open file descriptor 

echo arguments 

echo(I) echo arguments 

ecvt, fevt(1II]) output conversion 
edata(III) last locations in program 

ed(I) text editor- 

edit form letter memory 

editor output 

editor 

editor 

encoding 

end, etext, edata(III) last locations in program 
entries from name list 

entry 

errno(III) system error messages 

error messages...perror, Sys_errlist, 
errors 

etext, edata(III) last locations in program 
exception 

exec, execl, execv(II) execute a file 
execl, execv(II) execute a file 

execute a file 
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reset, setexit (III) 
sleep(I) suspend 
sleep(II) stop 
pause(II) suspend 
monitor(III) prepare 
profil (II) 

exec, execl, 


exp (III) 
pow(III) floating 
gsi(VI) interpret 

greek(VII) graphics for 
abs, 
factor(VI) discover prime 


abort(III) generate an IOT 


putc, putw, 
ecvt, 


putc, putw, fcreat, 

diff(1) differential 

dup(II) duplicate an open 
grep(I) search a 

ar(V) archive (library) 
split(I) split a 

setfil(III) specify Fortran 
read, open, onend(I) sequential 
stat(II) get 

icheck (VIII) 

check (VIII) 

dump(VIII) incremental 
restor(VIII) incremental 
mtab(VII) mounted 

fs(V) format of 

mkfs(VIII) construct a 
mount(II) mount 
mount(VIII) mount 
umount(II) dismount 
umount(VIII) dismount 
chmod (II) change mode of 
chown(II) change owner and group of a 
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execute non-local goto 
execution for an interval 
execution for interval 

execution indefinitely 

execution profile 

execution time profile 

execv(II) execute a file 

exit(I) terminate command file 
exit(II) terminate process 
exp(III) exponential function 
exponential function 
exponentiation 

extended character set on GSI terminal 
extended TTY-37 type-box 

fabs (III) absolute value 

factors of a number 

factor(V1) discover prime factors of a number 
fault | 

fc(1) Fortran compiler 

fcreat, fflush(III) buffered output 
fevt(III) output conversion 
fed(VI) edit form letter memory 
fflush(IIIl) buffered output 

file comparator 

file descriptor 

file for a pattern 

file format 

file into pieces 

file name 

file read 

file status 

file system consistency check and interactive repair 
file system consistency check 
file system dump 

file system restore 

file system table 

file system volume 

file system 

file system 

file system 

file system 

file system 

file 

file 
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close(II) close a 

core(V) format of core image 

creat(II) create a new 

dd(I) convert and copy a 

exec, execl, execv(II) execute a 

exit(I) terminate command 

file(I) determine format of 

fstat(II) get status of open 

hs(IV) RH11/RS03-RS04 fixed-head disk 


ino(VIII) get the i-number of a 

link(II) link to a 

mdate(II) set modified date on 
mknod(II) make a directory or a special 
mknod(VIII) build special 

mktemp(III) make a unique named temporary 
mv(I) move or rename a 

specify interrupt processing for a comm and 
passwd(V) password 

pr(I) print 

read(II) read from 

rf(IV) RF11/RS11 fixed-head disk 
cmp(I) compare two 

comm(I) print lines common to two 
find(1) find 

size(I) size of an object 

reloc(VIII) relocate object 

rm(i) remove (unlink) 

sort(I) sort or merge 

sum(I) sum 

uniq(I) report repeated lines in a 

. write(II) write on a 

find (1) 

hyphen(VI) 

typo(I) 


hs(IV) RH11/RS03-RS04 

rffdV) RFI1/RS11 

pfe(1) print 

pow (III) 

fmod (III) 

Itod(III) double precision integer to 
fptrap (III) 

dtol (111) 
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file(I) determine format of file 
file 

file 

file 

file 

file 

file 

file 

file...onintr (I) 

file 

file 

file 

file 

files 

files 

files 

file 

files 

files 

files 

file 

file 

file 

find files 

find hyphenated words 
find possible typos 
find(1) find files 
fixed-head disk file 
fixed-head disk file 
floating exception 
floating exponentiation 
floating modulo function 
floating point conversion 
floating point interpreter 
floating point to double precision integer conversion 


— 
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atof(III) convert ASCII to 
floor, ceil (IID) 


putchar, 
getc, getw, 


form(VI) 

fed(VI) edit 

core(V) 

dir(V) 

fs(V) 

file(I) determine 

nroff(]) 

ar(V) archive (library) file 
dump(V) incremental dump tape 
tp(V) DEC/mag tape 
printf (III) 

tmac(VI) macros for 


fc(1) 

ierror(III) catch 

setfil(III) specify 

iargc(III) get command arguments from 


df(VIII) disk 

read(II) read 

getarg, iargc(III) get command arguments 
nlist(III) get entries 

getpw(III) get name 


atan, atan2(III) arc tangent 
exp(III) exponential 

fmod (II) floating modulo 
gamma(III) log gamma 
floor, ceil(III) floor and ceiling 
sqrt(III) square root 

sin, cos(III) trigonometric 
—bjC(VI) the 

chess(VI) the 

wump(VI) the 

ttt(VI) the 

moo(VI) guessing 
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floor and ceiling functions 
floor, ceil(III) floor and ceiling functions 
flush(III) write character — 
fmod(III) floating madulo function 
fopen(III) buffered input 
fork(II1) spawn new process 
form letter generator 

form letter memory 

format of core image file 
format of directories 

format of file system volume 
format of file 

format text 

format 

format 

formats 

formatted print 

formatting manuscripts 
form(VI) form letter generator 
Fortran compiler 

Fortran errors 

Fortran file name 
Fortran...getarg, 

fptrap(1II) floating point interpreter 
free 

from file 

from Fortran 

from name list 

from UID 

fstat(II) get status of open file 
fs(V) format of file system volume 
function 

function 

function 
function 

functions 

function 

functions 

game of black jack 

game of chess 

game of hunt-the-wumpus 
game of tic-tac-toe 

game 


Bell Telephone Laboratories, Incorporated 
PROGRAM APPLICATION INSTRUCTION 


gamma(III) log 


tty (IV) 

abort (III) 

agen(VI) 

glob(VIII) 

lex (VI) 

form(VI) form letter 
rand, srand(III) random number 
getarg, iargc(III) 
time (II) 

nlist (III) 

stat (II) 

getgid (II) 

getpw(III) 

ge‘ pid (II) 

times (II) 

fstat II) 

ino(VIII) 

tty (1) 

gtty (II) 

getuid (II) 


getc, 
ctime, localtime, 


reset, setexit(III) execute non-local 
greek (VII) 


getgid(II) get 

setgid(II) set process 

chown(II) change owner and 

gsi(VI) interpret extended character set on 
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gamma function 

gamma(III) log gamma function 

general typewriter interface 

generate an IOT fault 

generate associative memory drivers 
generate command arguments 

generate programs for simple lexical tasks 
generator 

generator 

get command arguments from Fortran 

get date and time 

get entries from name list 

get file status 

get group identifications 

get name from UID 

get process identification 

get process times 

get status of open file 

get the i-number of a file 

get typewriter name 

get typewriter status 

get user identifications 

getarg, iargc(III) get command arguments from Fortran 
getc, getw, fopen(III) buffered input 

getchar (III) read character 

getgid(II) get group identifications 
getpid(II) get process identification 
getpw(III) get name from UID 

getty(VIII) set typewriter mode 

getuid(I]) get user identifications 

getw, fopen(III) buffered input 

glob(VIII) generate command arguments 
gmtime(III) convert date and time to ASCII 
goto(1) command transfer | 
goto 

graphics for extended TTY-37 type-box 
greek(VII) graphics for extended TTY-37 type-box 
grep(I) search a file for a pattern 

group identifications 

group ID 

group of a file 

GSI terminal 

gsi(V1) interpret extended character set on GSI terminal 
gtty(II) get typewriter status | 
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moo(VI) 

nohup(1) run a command immune to 
hmul (IID 

wtmp(V) user login 


wump(VI) the game of 
hyphen(VI) find 


hypot(III) calculate 


getarg, 

interactive repair... 
getpid(II) get process 
getgid(II) get group 
getuid(II) get user 
setgid(II) set process group 
setuid(II) set process user 


signal(II) catch or 

core(V) format of core 
nohup(I) run a command 
dump(V) 

dump(VIII) 

restor (VIII) 

pause(II) suspend execution 
ptx(VI) permuted 

indir (II) 


utmp(V) user 
ttys(V) typewriter 
init(VIII) process control 


clri(VIII) clear 


getc, getw, fopen(III) buffered 
floating point to double precision 
Itod(III) double precision 
atoi(III) convert ASCII to 

bc(I) arbitrary precision 

file system consistency check and 
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guessing game 

hangups 

high-order product 

history 

hmul(III) high-order product 

hp(IV) RH-11/RP04 moving-head disk 
hs(IV) RH11/RS03-RS04 fixed-head disk file 
ht(IV) RH-11/TU-16 magtape interface 
hunt-the-wumpus 

hyphenated words 

hyphen(VI) find hyphenated words 
hypotenuse 

hypot(III) calculate hypotenuse 
iargc(III]) get command arguments from Fortran 
icheck(VIII) file system consistency check and 
identification 

identifications 

identifications 

ID 

ID 

ierror(III) catch Fortran errors 

if(I) conditional command 

ignore signals 

image file 

immune to hangups 

incremental dump tape format 
incremental file system dump 
incremental file system restore 
indefinitely 

index 

indirect system call 

indir(II) indirect system call 
information 

initialization data 

initialization 

init(VIII) process control initialization 
i-node 

ino(VIII) get the i-number of a file 
input 

integer conversion...dtol (III) 

integer to floating point conversion 
integer 

interactive language 

interactive repair...icheck (VIII) 
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dsw(I) delete 

dc(IV) DC-11 communications 
dn(IV) DN-11 ACU 

dp(IV) DP-11 201 data-phone 
ht(IV) RH-11/TU-16 magtape 
kI(IV) KL-11 or DL-11 asynchronous 
tm(IV) TM-11/TU-10 magtape 
tty(IV) general typewriter 

gsi(VI) 

fptrap(III) floating point 

sh(I) shell (command 

sno(VI) Snobol 

pipe(II) create an 

onintr(I) specify 

return(I) terminate profile or 
sleep(I) suspend execution for an 
sleep(II) stop execution for 
intro(II) 


ino(VIII) get the 
abort(III) generate an 
bj(VI) the game of black 


kIV) 


mem, 
bc(I) arbitrary precision interactive 
end, etext, edata(III) 


form(VI) form 
fed(VI) edit form 
lex(VI) generate programs for simple 


ar(V) archive 

ar(I) archive and 

Ic(1) 

Ipd( VIII) 

ipr(I) 

Ip(IV) 

comm(I) print 

uniq(I) report repeated 
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interactively 

interface 

interface 

interface 

interface 

interface 

interface 

interface 3 

interpret extended character set.on GSI terminal 
interpreter 

interpreter) 

interpreter 

interprocess channel 

interrupt processing for a command file 
interrupt processing routine 

interval 

interval 

introduction to system calls 

intro(II) introduction to system calls 
i-number of a file 

IOT fault 

jack 

kill(I) terminate a process 

kill(1I]) send signal to a process 

KL-11 or DL-11 asynchronous interface 
kI(IV) KL-11 or DL-11 asynchronous interface 
kmem, null(1V) core memory 
language 

last locations in program 

Ic(I) LIL compiler 

Id() link editor 

Idiv, Irem(IH) long division 

letter generator 

letter memory 

lexical tasks 

lex(VI) generate programs for simple lexical tasks 
(library) file format 

library maintainer 

LIL compiler 

line printer daemon 

line printer spooler 

line printer 

lines common to two files 

lines in a file 
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a.out(V) assembler and 
Id(D 
link (I) 


In(I) make a 

Is(I) 

cref(I) make cross reference 
nlist(III) get entries from name 
nm(I) print name 


ctime, 
end, etext, edata(III) last 


gamma(III) 
log(III) natural 


ac( VIII) 
wtmp(V) user 
passwd(I) change 


Idiv, Irem (IID) 
locv (IID) 
nice(I) run a command at 


Idiv, 


conversion... 

tmac(VI) 

mtm (I) 

ht(IV) RH-11/TU-16 

tm(IV) TM-11/TU-10 

tp(I) manipulate DECtape and 
mail(I) send 


ar(I) archive and library 
mknod (II) 

mkdir(I) 

In(I) 

mktemp (III) 

cref(I) 

tp (I) 


link editor output 
link editor 

link to a file 

link(ID) link to a file 
link 


list contents of directory 


listing 

list 

list 

In(I) make a link 


localtime, gmtime (III) convert date and time to ASCII 


locations in program 

lock(II) semaphores 

locv(III) long output conversion 
log gamma function 

logarithm 

log (III) natural logarithm 

login accounting 

login history 

login password 

login(I) sign onto UNI 

long division 3 

long output conversion 

low priority 

Ipd(VIII) line printer daemon 
Ip(IV) line printer 

Ipr(I) line printer spooler 
lrem(III) long division 

Is(I) list contents of directory 
Itod(1I[) double precision integer to floating point 
macros for formatting manuscripts 


_ magnetic tape manipulation 


magtape interface 


_Magtape interface 


magtape | 

mail to designated users 

mail(I) send mail to designated users 
maintainer | 

make a directory or a special file 
make a directory 

make a link 

make a unique named temporary file 
make cross reference listing 
manipulate DECtape and magtape 
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mtm(I) magnetic tape 
tmac(VI) macros for formatting 
ascii (VII) 


agen(VI) generate associative 
fed(VI) edit form letter 
mem, kmem, null(IV) core 
sort(I) sort or 


mesg (III) write 
mesg(I) permit or deny 
sys_nerr, errno(III) system error 


chmod (II) change 

stty (II) set 

chmod(I) change 
getty(VIII) set typewriter 
mdate(II) set 

fmod(III) floating 


mount(II) 
mount(VIII) 
mtab(VII) 


mv (I) 

seek (II) 

hp(lV) RH-11/RP04 
rp(IV) RP-11/RP03 


dh(IV) DH-11 communications 


getpw(III) get 

nlist (III) get entries from 
nm(I) print 

ttyn (III) return 
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manuscripts 

map of ASCII character set 
mdate(II) set modified date on file 
mem, kmem, null(IV) core memory 
memory drivers 

memory 

memory 

merge files 

mesg(I) permit or deny messages 
mesg (III) write message on typewriter 
message on typewriter 

messages 

messages...perror, sys _errlist, 
mkdir(1) make a directory 
mkfs(VIII) construct a file system 
mknod(II) make a directory or a special file 
mknod(VIII) build special file 
mktemp(III) make a unique named temporary file 
mode of file 

mode of typewriter 

mode 

mode 

modified date on file 

modulo function 

monitor(III) prepare execution profile 
moo(V1) guessing game 

mount file system 

mount file system 

mounted file system table 

mount(II) mount file system 
mount(VIII) mount file system 
move or rename a file 

move read/write pointer 
moving-head disk 

moving-head disk 

mtab(VII) mounted file system table 
mtm(I) magnetic tape manipulation 
multiplexer 

mv(I) move or rename a file 

name from UID 

name list 

name list 

name of current typewriter 
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mktemp(III) make a unique 
pwd(I) working directory 
setfil(III) specify Fortran file 
tty(I) get typewriter 


log (III) 
creat(II) create a 
fork (II) spawn 


reset, seiexit(III) execute 


mem, kmem, 

rand, srand(III) random 

factor(VI) discover prime factors of a 
size(I) size of an 

reloc(VIII) relocate 

od (I) 


read, open, 

file... 

login(I) sign 

dup(II) duplicate an 
fstat(II) get status of 
open (II) 

read, 


stty(I) set typewriter 

rk(IV) RK-11/RKO03 

ecvt, fevt (IIT) 

locv(III) long 

a.out(V) assembler and link editor 
 putc, putw, fcreat, fflush(III) buffered 
chown(II) change 

chown(VIII) change 

pe(IV) PC-11 


crypt (III) 
passwd(V) 
passwd(I) change login 
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named temporary file 

name 

name 

name 

nargs(III) argument count 

natural logarithm 

new file 

new process 

nice(I) run a command at low priority 
nice(II) set program priority 
nlist(III) get entries from name list 
nm(I) print name list 

nohup(I) run a command immune to hangups 
non-local goto 

nroff(I) format text 

null(IV) core memory 

number generator 

number 

object file 

object files 

octal dump 

od(I) octal dump 

onend(I) sequential file read 
onintr(I) specify interrupt processing for a command 
onto UNIX 

open file descriptor 

open file 

open for reading or writing 

open, onend(I) sequential file read 
open(II) open for reading or writing 
options 

(or RKOS5) disk 

output conversion 

output conversion 


output 


output 


owner and group of a file 


owner 
paper tape reader/punch 
passwd (I) change login password 


- passwd(V) password file 


password encoding 
password file 
password 


Bell Telephone Laboratories, Incorporated 
PROGRAM APPLICATION INSTRUCTION 


grep(I) search a file for a 
pce(IV) 


update(VIII) 
mesg (I) 

ptx (VI) 

error messages... 


dpd(VIII) data 
split(1) split a file into 


double precision integer to floating 
fptrap(III) floating 

dtol(III) floating 

seek (II) move read/write 

typo(I) find 


dtol(III) floating point to double 
Itod (III) double 

bc(I) arbitrary 

monitor(II]) 


factor(VI) discover 
date (I) 

cal(VI) 

pr(I) 

pfe (I) 

comm (]) 

nm(1) 

cat(I) concatenate and 
Ipd(VIII) line 
Ipr(I) line 

Ip(IV) line 


printf(III) formatted 

nice(I) run a command at low 
nice(II) set program 

su(VIII) become 

boot 

init(VIIT) 

setgid(II) set 

getpid(II) get 

ps (I) 
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pause(II) suspend execution indefinitely 
PC-11 paper tape reader/punch 

pc(IV) PC-11 paper tape reader/punch 
periodically update the super block 
permit or deny messages 

permuted index 

perror, sys _errlist, sys_nerr, errno(III) system 
pfe(I) print floating exception 

phone daemon 

pieces 

pipe(II) create an interprocess channel 
point conversion...ltod (III) 

point interpreter 

point to double precision integer conversion 
pointer 

possible typos 

pow(III) floating exponentiation 
precision integer conversion 

precision integer to floating point conversion 
precision interactive language 

prepare execution profile 

pr(I) print file 

prime factors of a number 

print and set the date 

print calendar 

print file 

print floating exception 

print lines common to two files 

print name list 

print 

printer daemon 

printer spooler 

printer 

printf(III) formatted print 

print 

priority 

priority 

privileged user 

procedures(VIII) UNIX startup 
process control initialization 

process group ID 

process identification 

process status 
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times(II) get 

wait(II) wait for 

setuid (II) set 

exit(II) terminate 

fork(II) spawn new 
onintr(I) specify interrupt 
return(]) terminate profile or interrupt 
kill(]) terminate a 

kill(II) send signal to a 
wait(I) await completion of 
hmul(IID high-order 


prof(I) display 

return(I) terminate 
monitor(III) prepare execution 
profil(II) execution time 


nice(II) set 
end, etext, edata(III) last locations in 
lex(VI) generate 


putc, 
compar (III) default comparison routine for 
qsort (III) 


rand, srand(III) 
getchar (III) 
csw(II) 

read (II) 


pe(IV) PC-11 paper tapc 


open(II) open for 

read, open, onend(I) sequential file 
seek (II) move 

cref(I) make cross 

reloc(VIII) 

strip(I) remove symbols and 
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process times 

process to terminate 

process user ID 

process 

process 

processing for a command file 
processing routine 

process 

process 

process 

product 

prof(I) display profile data 

profile data 

profile or interrupt processing routine 
profile 

profile 

profil(II) execution time profile 
program priority 

program 

programs for simple lexical tasks 
ps(I) process status 

ptx(VI) permuted index 

putc, putw, fcreat, fflush(III) buffered output 
putchar, flush(III) write character 
putw, fcreat, fflush(III) buffered output 
pwd(I) working directory name 

qsort 

qsort(III) quicker sort 

quicker sort 

rand, srand(III) random number generator 
random number generator 

read character 

read console switches 

read from file | 

read, open, onend(I) sequential file read 
reader/punch 

read(II) read from file 

reading or writing 

read 

read/write pointer 

reference listing 

relocate object files 

relocation bits 

reloc(VIII) relocate object files 
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unlink (II) 

rmdir (I) 

strip (1) 

rm(I) 

mv(I) move or 

system consistency check and interactive 
uniq(I) report 

uniq(I) 


restor(VIII) incremental file system 


ttyn (IIT) 
routine... 


rew(1) 
rf(IV) 


hp(IV) 
hs(1V) 
ht(IV) 
rk(IV) RK-11/RK03 (or 
rk (IV) 


sqrt(III) square 

compar (III) default comparison 
terminate profile or interrupt processing 
rp(IV) 


nice (I) 
nohup(I) 


break, brk, 
grep(I) 


lock (II) 

mail (I) 

kill) 

read, open, onend(I) 

stty (II) 

mdate (IJ) 

gsi(VI) interpret extended character 
setgid (II) 
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remove directory entry 

remove directory 

remove symbols and relocation bits 
remove (unlink) files 

rename a file 

repair...icheck(VIII) file 

repeated lines in a file 

report repeated lines in a file 

reset, setexit(III) execute non-local goto 
restore 

restor(VIII) incremental file system restore 
return name of current typewriter 
return(I) terminate profile or interrupt processing 
rew(I) rewind tape 

rewind tape 

RF11/RS11 fixed-head disk file 

rf(IV) RFI1/RS11 fixed-head disk file 
RH-11/RPO4 moving-head disk 
RH11/RS03-RS04 fixed-head disk file 
RH-11/TU-16 magtape interface 
RKOS) disk 

RK-11/RK03 (or RKOS) disk 

rk(IV) RK-11/RK03 (or RKOS) disk 
rmdir(I) remove directory 

rm(I) remove (unlink) files 

root function 

routine for qsort 

routine...return(I) 

RP-11/RP03 moving-head disk 

rp(I1V) RP-11/RP03 moving-head disk 
run a command at low priority 

run a command immune to hangups 
sa(VIII) Shell accounting 

sbrk (II) change core allocation 

search a file for a pattern 

seek (II) move read/write pointer 
semaphores 

send mail to designated users 

send signal to a process 

sequential file read 

set mode of typewriter 

set modified date on file 

set on GSI terminal 

set process group ID 
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setuid (II) 

nice(II) 

tabs(VII) 

date(I) print and 

stime (II) 

getty (VIII) 

stty (I) 

ascii(VII) map of ASCII character 
reset, 


sa(VIII) 
shift(I) adjust 
sh(I) 


login (1) 
kill(II) send 


signal(II) catch or ignore 
lex(VI) generate programs for 


size (I) 


sno(VI) 
sort (I) 


qsort(III) quicker 

fork (II) 

mknod (II) make a directory or a 
mknod(VIII) build 

setfil (II) 

onintr(I) 

split) 


ipr(I) line printer 


sart (III) 
rand, 


boot procedures(VIII) UNIX 
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set program priority 

set tab stops 

set the date 

set time 

set typewriter mode 

set typewriter options 

set 

setexit(III]) execute non-local goto 
setfil(II1) specify Fortran file name 
setgid(II) set process group ID 
setuid(II) set process user ID 

Shell accounting 

Shell arguments 

shell (command interpreter) 

sh(I) shell (command interpreter) 
shift(1) adjust Shell arguments 

sign onto UNIX 

signal to a process 

signal (II) catch or ignore signals 
Signals 

simple lexical tasks 

sin, cos(III) trigonometric functions 
size of an object file 

size(I) size of an object file 

sleep(I) suspend execution for an interval 
sleep(II) stop execution for interval 
Snobol interpreter 

sno(VI) Snobol interpreter 

sort or merge files 

sort(I) sort or merge files 

sort 

spawn new process 

special file 

special file 

specify Fortran file name 

specify interrupt processing for a command file 
split a file into pieces 

split(1) split a file into pieces 
spooler 

sqrt(III) square root function 
square root function 

srand(III) random number generator 
startup : 
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fstat(II) get 

gtty(II) get typewriter 
ps(I) process 

stat(II) get file 


sleep (II) 
tabs(VII) set tab 


sum (I) 


du(1) 

sync(VIII) update the 

update(VIII) periodically update the 
sync(II) update 

sleep (1) 

pause (II) 


csw(II) read console 
strip(]) remove 


messages...perror, 

perror, sys_errlist, 

indir(II) indirect 

intro(II) introduction to 
icheck(VIII) file 

check(VIII) file 

crash(VIII) what to do when the 
dump(VIII) incremental file 
-_Sys_errlist, sys_nerr, errno(III) 
restor(VIII) incremental file 
mtab(VII) mounted file 

fs(V) format of file 

mkfs(VIII) construct a file 
mount(II) mount file 
mount(VIII) mount file 
umount(II) dismount file 


umount(VIII) dismount file. 


who(I) who is on the 
tabs(VII) set 
mtab(VII) mounted file system 
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stat(II) get file status 

status of open file 

Status 

Status 

Status 

stime(II) set time 

stop execution for interval 

stops 

strip(I) remove symbols and relocation bits 
stty(I) set typewriter options 

stty (II) set mode of typewriter 
sum file 

sum (I) sum file 

summarize disk usage 

super block 

super block 

super-block 

suspend execution for an interval 
suspend execution indefinitely 
su(VIII) become privileged user 
switches 

symbols and relocation bits 
sync(II) update super-block 
sync(VIII) update the super block 
sys _errlist, sys nerr, errno(III) system error 
sys_nerr, errno(III) system error messages 
system call 

system calls 

system consistency check and interactive repair 
system consistency check 

system crashes 

system dump 

system error messages.. perror, 
system restore 

system table 

system volume 

system 

system 

system 

system 

system 

system 

tab stops 

table 
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atan, atan2(III) arc 

dump(V) incremental dump 

tp(V) DEC/mag 

mtm(I) magnetic 

pce(IV) PC-11 paper 

rew(I) rewind 

generate programs for simple lexical 
tc(IV) 


mktemp(III) make a unique named 
interpret extended character set on GSI 
kill (I) 

exit (I) 

exit (II) 

return (I) 

wait(II) wait for process to 

ed(I) 

nroff(I) format 

cubic(VI) 

cubic(VI) three dimensional 

ttt(VI) the game of 

time (I) 

profil(1I) execution 

localtime, gmtime(III) convert date and 


alarm(II) activate alarm clock 
stime(II) set 
times(II) get process 


time(II) get date and 
tm(IV) 


goto(I) command 
tr(I) 


sin, cos(III) 


greek(VII) graphics for extended 
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tabs(VII) set tab stops 

tangent function 

tape format 

tape formats 

tape manipulation 

tape reader/punch 

tape 

tasks...lex (VI) 

TC-11/TUS6 DECtape 

tc(IV) TC-11/TU56 DECtape 
temporary file 

terminal...gsi(VI) 

terminate a process 

terminate command file 
terminate process 

terminate profile or interrupt processing routine 
terminate 

text editor 

text 

three dimensional tic-tac-toe 
tic-tac-toe 

tic-tac-toe 

time a command 

time profile 

time to ASCII...ctime, 

time(1) time a command 
time(II) get date and time 

timer 

times(II) get process times 

time 

times 

time 

TM-11/TU-10 magtape interface 
tmac(VI) macros for formatting manuscripts 
tm(IV) TM-11/TU-10 magtape interface 
tp(I) manipulate DECtape and magtape 
tp(V) DEC/mag tape formats 
transfer 

transliterate 

tr(i) transliterate 

trigonometric functions 

ttt(VI) the game of tic-tac-toe 
TTY-37 type-box 

tty(1) get typewriter name 
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cmp(I) compare 

comm(I) print lines common to 
greek(VII) graphics for extended TTY-37 
ttys(V) 

tty(IV) general 

getty(VIII) set 

tty(I) get 

stty(I) set 

gtty(II) get 

mesg (III) write message on 

stty (II) set mode of 

ttyn (III) return name of current 


typo(I) find possible 
getpw(III) get name from 


mktemp(III) make a 
boot procedures(VIII) 
login(I) sign onto 
rm(I) remove 


sync(II) 
sync( VIII) 
update(VIII) periodically 


du(I) summarize disk 
getuid(II) get 

setuid(II) set process 

utmp(V) 

wtmp(V) 

mail(I) send mail to designated 
su(VIII) become privileged 
wall(VIII) write to all 

write(I) write to another 


abs, fabs(III) absolute 
fs(V) format of file system 
wait (11) 
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tty(IV) general typewriter interface 
ttyn(II]) return name of current typewriter 
ttys(V) typewriter initialization data 
two files 

two files 

type-box 

typewriter initialization data 
typewriter interface 

typewriter mode 

typewriter name 

typewriter options 

typewriter status 

typewriter 

typewriter 

typewriter 

typo(I) find possible typos 

typos 

UID 

umount(II) dismount file system 
umount(VIII) dismount file system 
uniq(I) report repeated lines in a file 
unique named temporary file 
UNIX startup 

UNIX 

(unlink) files 

unlink(II) remove directory entry 
update super-block 

update the super block 

update the super block 
update(VIII) periodically update the super block 
usage 

user identifications 

user ID 

user information 

user login history 

users 

user 

users 

user 

utmp(V) user information 

value 

volume 

wait for process to terminate 
wait(I) await completion of process 
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crash(VIII) 
who(I) 


wc(I) 

hyphen(VI) find hyphenated 
pwd (I) 

chdir(I) change 

chdir(II) change 

putchar, flush (III) 

mesg (III) 

write(II) 

wall (VIID) 

write (I) 


open(II) open for reading or 


yacc(I) 
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-wait(II) wait for process to terminate 
wall(VIII) write to all users 

wc(I) word count 

what to do when the system crashes 
who is on the system | 
who(I) who is on the system 

word count 

words 

working directory name 

working directory 

working directory 

write character 

write message on typewriter 

write on a file | 

write to all users 

write to another user 

write(I) write to another user 
write(II) write on a file 

writing 

wtmp(V) user login history 
wump(VI) the game of hunt-the-wumpus 
yacc(I) yet another compiler-compiler 
yet another compiler-compiler 


I CoMMANDS 
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NAME 
ar — archive and library maintainer 


SYNOPSIS 
ar key [ posname ] afile [ name ... ] 


DESCRIPTION 
Ar maintains groups of files combined into a single archive file. Its main use is to create and 


update library files as used by the loader. It can be used, though, for any similar purpose. 


Key is one character from the command set drtlpmx optionally concatenated with characters 
from the option set vunab. A/file is the archive file. The names are constituent files in the ar- 
chive file. The posname is the name of a file in the archive; it is required if and only if one of 
the options a or b is used in the key. The meanings of the Ae) characters are: 


d Delete the named files from the archive file. 

r Replace or add the named files. New files are placed at the end of the archive unless the 
a or b option is used. Existing files are replaced in their current position and a or b have 
no effect. 

t Print a table of contents of the archive file. If no names are given, all files in the archive 
are tabled. 

| List the contents of the archive in long mode, giving mode, owner, size in bytes and 
time of last modification for each file. If no names are given, all files are listed. 

0 Print the named files in the archive. 

m Move the named files to the end of the archive or as specified by the a or b option. 

X Extract the named files. If no names are given, all files in the archive are extracted. If 


the optional character u is used with x, only those files with a modified date earlier than 
the dates of the respective files within the archive will be replaced by extracted files. 


v Verbose; under the verbose option, ar gives additional information while working: 


d,r,m_ gives log of changes to archive. 


x logs files extracted. | 
t,l changes t command into | command. 
p prints name of file before printing file. 
u Update, under the update option ar, in replacing or extracting, will only over-write an 


older version of a file, if versions exist both within and without the archive (see r and x 


command descriptions). 
If u is part of a key with no command character, r is included as the command. 


n Interactive, under the interactive option, avr requests information from the standard input 
before modifying the archive. 


r before creating the archive, ar prints: 
2? - afile? 
Reply ‘y’ to create the archive; any other response and ar will abort. 


m before modifying the archive, ar prints: 
n - fillenume? 
Reply with a new name to rename the file; an illegal filename or just a return 
will retain the old name. 


d before deleting any file, av prints: 
d - filename? 
Reply ‘y’ to delete the file; any other reply and the file will be kept. 
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a,b —srrearranges files in the archive file, placing them after or before the file designated as 
posname. These epyons require that posname follow the key. 


FILES 
/‘tmp/vtm? temporary 


SEE ALSO 
Id (1), archive (V) 


BUGS | 
if the same file is mentioned twice in an argument list, it may be put in the archive twice. The 
options a and b should work with r when the file already exists in the archive. 


Bell Telephone Laboratories, Incorporated -l- PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section | 
| Issue 1, January 1976 

AT&TCo SPCS 


AS (1) | AS (1) 


NAME 
as — assembler 


SYNOPSIS 
as [ — ] name... 


DESCRIPTION | 
As assembles the concatenation of the named files. If the optional first argument — is used, all 
undefined symbols in the assembly are treated as global. 


The output of the assembly is left on the file a.out. It is executable if no errors occurred dur- 
ing the assembly, and if there were no unresolved external references. 


FILES 
/\ib/as2 pass 2 of the assembler 
/tmp/atm[1-3]? temporary 
a.out object 
SEE ALSO 
Id (1), nm (1), db (1), a.out (V), ‘UNIX Assembler Manual’. 
DIAGNOSTICS 
When an input file cannot be read, its name followed by a question mark is typed and assembly 
ceases. When syntactic or semantic errors occur, a single-character diagnostic is typed out to- 
gether with the line number and the file name in which it occurred. Errors in pass | cause can- 
cellation of pass 2. The possible errors are: 
) Parentheses error 
] Parentheses error 
< String not terminated properly 
" Indirection used illegally 
: Illegal assignment to °.’ 
A Error in address 
B Branch instruction is odd or too remote 
E Error in expression 
F Error in local (‘f or ‘b’) type symbol 
G Garbage (unknown) character 
I] End of file inside an if 
M Multiply defined symbol as label 
O Word quantity assembled at odd address 
P ‘.” different in pass 1 and 2 
R Relocation error 
U Undefined symbol 
Xx Syntax error 
BUGS 


Symbol table overflow is not checked. X errors can cause incorrect line numbers in following 
diagnostics. 
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bas — basic 
SYNOPSIS 
bas [ file } 
DESCRIPTION 


Bas is a dialect of Basic. If a file argument is provided, the file is used for input before the con- 
sole is read. Bas accepts lines of the form: 


statement 
integer statement 


Integer numbered statements (known as internal statements) are stored for later execution. 
They are stored in sorted ascending order. Non-numbered statements are immediately execut- 


ed. The result of an immediate expression statement (that does not have ‘=’ as its highest 
Operator) is printed. 


Statements have the following syntax: 


expression 
The expression is executed for its side effects (assignment or function call) or for panting 
as described above. 


done 
Return to system level. 


draw. expression expression expression 
A line is drawn on the Tektronix 611 display ‘/dev/vt0’ from the current display position 
to the XY co-ordinates specified by the first two expressions. The scale is zero to one in 
both X and Y directions. If the third expression is zero, the line is invisible. The current 
display position is set to the end point. 


display list | 
The list of expressions and strings is concatenated and displayed (i.e. printed) on the 611 
Starting at the current display position. The current display position is not changed. 


erase 
The 611 screen is erased. 


fer name = expression expression statement 
for name = expression expression 


next 
The for statement repetitively executes a statement (first form) or a group of statements 
(second form) under control of a named variable. The variable takes on the value of the 
first expression, then is incremented by one on each loop, not to exceed the value of the 
second expression. 


gote expression 8 
| The expression is evaluated, truncated to an integer and execution goes to the 
corresponding integer numbered staiment. If executed from immediate mode, the inter- 
nal statements are compiled first. : | 


if expression statement 
The statement is executed if the expression evaluates to non-zero. 


ist [expression [expression]] 
is used to print out the stored internal statements. If no arguments are given, all internal 
statements are printed. If one argument is given, only that internal statement is listed. If 


two arguments are given, all internal statements inclusively between the arguments are — 


printed. 
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print list 
The list of expressions and strings are concatenated and printed. (A string is delimited by 
double quotes.) 


return [expression] 
The expression is evaluated and the result is passed back as the value of a function call. 
If no expression is given, zero is returned. 


run 
The internal statements are compiled. The symbol table is re-initialized. The random 
number generator is reset. Control is passed to the lowest numbered internal statement. 


Expressions have the following syntax: 


name 
A name is used to specify a variable. Names are composed of a letter followed by letters 
and digits. The first four characters of a name are significant. 


number | 
A number is used to represent a constant value. A number is written in Fortran style, 
and contains digits, an optional decimal point, and possibly a scale factor consisting of ane 
followed by an optionally signed exponent. 


( expression ) 
Parentheses are used to alter normal order of evaluation. 


expression operator expression 
Common functions of two arguments are abbreviated by the two arguments separated by 
an operator denoting the function. A complete list of operators is given below. 


expression ( [expression [ , expression] ... ] ) 
Functions of an arbitrary number of arguments can be called by an expression followed by 
the arguments in parentheses separated by commas. The expression evaluates to the line 
number of the entry of the function in the internally stored statements. This causes the 
internal statements to be compiled. If the expression evaluates negative, a built-in func- 
tion is called. The list of built-in functions appears below. 


name | expression [ , expression ] ... 
Each expression is truncated to an integer and used as a specifier for the name. The 
result is syntactically identical to a name. al1,2] is the same as al1]{2]. The truncated ex- 
pressions are restricted to values between 0 and 32767. 


The following is the list of operators: 


= is the assignment operator. The left operand must be a name or an array element. The 
result is the right operand. Assignment binds right to left, all other operators bind left to 
right. 


& | 
& (logical and) has result zero if either of its arguments are zero. It has result one if both 
its arguments are non-zero. | (logical or) has result zero if both of its arguments are zero. 
It has result one if either of its arguments are non-zero. 


< <= > = == <> 
The relational operators (< less than, <= less than or equal, > greater than, >= greater 
than or equal, == equal to, <> not equal to) return one if their arguments are in the 
specified relation. They return zero otherwise. Relational operators at the same level ex- 
tend as follows: a>b>c is the same as a>b&b>c. 


+ — . 
Add and subtract. 
ey 

Multiply and divide. 
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Exponentiation. 
The following is a list of built-in functions: 


arg (i) 
is the value of the /-th actual parameter on the current level of function call. 


exp(x) 
is the exponential function of x. 


dg (x) 


is the natural logarithm of x. 


sin (x) 
is the sine of x (radians). 


cos (x) 
is the cosine of x (radians). 
atn (x) 
is the arctangent of x. Its value is between —7/2 and 7/2. 
rnd() 
is a uniformly distributed cancom number between zero and one. 
expr( ) 
is the only form of program input. A line is read from the input and evaluated as-an ex- 
pression. The resultant value is returned: 
int (x) 
returns x truncated to an integer. 


FILES 
/tmp/btm? temporary 
DIAGNOSTICS 
Syntax errors cause the incorrect line to be typed with an underscore where the parse failed. 
All other diagnostics are self explanatory. | 
BUGS 


Has been known to give core images. Needs a way to /ist a program onto a file. 
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NAME 

bc — arbitrary precision interactive language 
SYNOPSIS 

be { —1] [ file ... ] 
DESCRIPTION 


Bc is an interactive processor for a language which resembles C but provides unlimited preci- 
sion arithmetic. It takes input from any files given, then reads the standard input. The ‘—I’ ar- 
gument stands for the name of a library of mathematical subroutines which contains sine 
(named ‘s’), cosine (‘c’), arctangent (‘a’), natural logarithm (‘I’), and exponential (‘e’). The 
syntax for bc programs is as follows; E means expression, S means statement. 


Comments 
are enclosed in /* and “/. 


Names 
letters a—z 
array elements: letter[E] 
the words ‘ibase’, ‘obase’, and ‘scale’ 


Other operands 
arbitrarily long numbers with optional sign and decimal point 
(E) 
sqrt CE ) 
<letter> (E,...,E) 


Operators 
ee 
++ —— (prefix and postfix; apply to names) 


Statements 
E 
{(S:..;S] 
if(E)S 
while (E) § | 
for(E;,;E;E)S 
null statement 
break 
quit 
Function definitions are exemplified by 
define <letter> ( <letter> ,..., <letter> ) { 
auto <letter>, ... , <letter> 
S;...8 
return ( E ) 


All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the main operator is an assign- 
ment. Either semicolons or newlines may separate statements. Assignment to sca/e influences 
the number of digits to be retained on arithmetic operations. Assignments to ‘base or obase set 
the input and output number radix respectively. 


The same letter may be used as an array name, a function name, and a simple variable simul- 
taneously. ‘Auto’ variables are saved and restored during function calls. All other variables are 
global to the program. When using arrays as function arguments or defining them as automatic 
variables empty square. brackets must follow the array name. 
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For example 
scale = 20 


define e(x) { 
auto a, b, c, i, Ss 


a=] 
b= 1 
s=] 
for(i=1; 1; i++) 
a=a"x 
b = b*i 
c = a/b 
if(c == 0) return(s) 
S = s+c 


defines a function to compute an approximate value of the exponennal function and 
for(i=l; i<=10; i++) e(i) 


prints approximate values of the exponent! function of the first ten integers. 


FILES 

/usr/lib/lib.b |§mathematical eer 
SEE ALSO 

dc (1), C Reference Manual, ‘‘BC — An Arbitrary Precision Desk- Calculator Language.” 
BUGS 


No &&, || yet. 3 
for statement must have all (izes E's 
quit is interpreted when read, not when executed. 
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NAME 
cat — concatenate and print 


SYNOPSIS 
cat file ... 


DESCRIPTION | 
Cat reads each file in sequence and writes it on the standard output. Thus 
cat file 
prints the file, and 
cat filel file2 > file3 
concatenates the first two files and places the result on the third. 


3 


If no input file is given, or if the argument ‘— 
put file. 


is encountered, cat reads from the standard in- 


SEE ALSO 
pr (I), cp (I) 


DIAGNOSTICS 
None; if a file cannot be found, it is ignored. 


BUGS 
cat x y >x and cat x y >y should be avoided. 
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NAME 
cc — C compiler 
SYNOPSIS 
ec{—-c]{[—p]{—-f][—-O][—-S][-—P] file... 
DESCRIPTION 


Cc is the UNIX C compiler. It accepts three types of arguments: 


Arguments whose names end with *.c’ are taken to be C source programs; they are compiled, 
and each object program is left on the file whose name is that of the source with ‘.o’ substituted 
for ‘.c’. The ‘.o° file is normally deleted, however, if a single C program is compiled and loaded 
all at one go. 


The following flags are interpreted by cc. See /d (I) for load-time flags. 


~—c Suppress the loading phase of the compilation, and force an object file to be produced 
even if only one program is compiled. 


—p Arrange for the compiler to produce code which counts the number of times each 
routine is called; also, if loading takes place, replace the standard startup routine by one 
which automatically calls the monitor (III) subroutine at the start and arranges to write 
Out a mon.out file at normal termination of execution of the object program. An execu- 
tion profile can then be generated by use of prof (I). 


—f In systems without hardware floating-point, use a version of the C compiler which han- 
dies floating-point constants and loads the object program with the floating- -point inter- 
preter. Do not use if the hardware is present. 


—QO Invoke an object-code optimizer. 


—S Compile the named C programs, and leave the assembler-language output on 
corresponding files suffixed ‘.s’. 


—P Run only the macro preprocessor on the named C programs, and leave the output on 
corresponding files suffixed ‘.i’. 


- Other arguments are taken to be either loader flag arguments, or C-compatible object programs, 
typically produced by an earlier cc run, or perhaps libraries of C-compatible routines. These 
programs, together with the results of any compilations specified, are loaded (in the order 
given) to produce an executable program with name a.out. 


FILES 

file.c input file 

file.o object file 

a.out loaded output 

/tmp/ctm? temporary 

/lib/c (01) compiler 

/lib/fc[01} floating-point compiler 

/lib/c2 optional optimizer 

/tib/crt0.o runtime startoff 

/lib/mcrt0.o runtime startoff of profiling 

/lib/fcrt0.o runtime startoff for floating-point interpretation 

/lib/libe.a C library; see section III. 

/lib/liba.a Assembler library used by some routines in libc.a 
SEE ALSO 

‘‘Programming in C— a tutorial,’” C Reference Manual, monitor (III), prof (1), cdb (I), Id (I). 
DIAGNOSTICS 


The diagnostics produced by C itself are intended to be self-explanatory. Occasional messages 
may be produced by the assembler or loader. Of these, the most mystifying are from the as- 
sembler, in particular ‘‘m,’’ which means a multiply-defined external symbol (function or data). 


Beil Telephone Laboratories, Incorporated -l- . PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section | 
Issue 1, January 1976 

AT&TCo SPCS 


CDB (1) CDB (1) 


NAME 
cdb — C debugger 


SYNOPSIS 
edb [ core [ a.out ]] 


DESCRIPTION 
Cdb is a debugging program for use with C programs. It is by no means completed, and this 
section is essentially only a placeholder for the actual description. 


Even the present cdb has one useful feature: the command 
$ 


will give a stack trace of the core image of a terminated C program. The calls are listed in the 
order made; the actual arguments to each routine are given in octal. 


SEE ALSO 
cc (1), db (I), C Reference Manual 


BUGS 
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NAME 


chdir — change working directory 


SYNOPSIS 
chdir directory 


DESCRIPTION 


Directory becomes the new working directory. The process must have execute (search) permis- 
sion in directory. 


Because a new process is created to execute each command, chdir would be ineffectwe if it were 
written as a normal command. It is therefore recognized and executed by the Shell. 


SEE ALSO 
sh (I), pwd (I) 


BUGS 
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NAME 
chmod — change mode 


SYNOPSIS 
chmod octal file ... 


DESCRIPTION 
The octal mode replaces the mode of each of the files. The mode is constructed from the OR 
of the following modes: 


4000 = set user ID on execution 

2000 _~—s set group ID on execution 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 
0070 read, write, execute (search) by group 
0007 read, write, execute (search) by others 


Only the owner of a file (or the super-user) may change its mode. 


SEE ALSO 
is (I), chmod (ID) 


BUGS 
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NAME 
cmp — compare two files 
SYNOPSIS 
amp [ —s ] [ —1] file! file2 
DESCRIPTION 


The two files are compared. Under default options, cmp makes no comment if the files are the 
same; if they differ, it announces the byte and line number at which the difference occurred. If 
one file is an initial subsequence of the other, that fact is noted. Moreover, return code 0 is 
yielded for identical files, 1 for different files, and 2 for an inaccessible or missing asgument. 


The optional argument —s is used to make a silent compare and only set the return code. The 
optional argument —! prints all differences in octal and can be used to compare binary files. 


SEE ALSO 
diff (I), comm (I) 


BUGS 


Bell Telephone Laboratories, Incorporated -l- PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section | 
Issue 1, January 1976 

AT&TCo SPCS 


COMM (I) COMM (7) 
NAME 
comm — print lines common to two files 
SYNOPSIS 
comm [ — [ 123 ] ] file] file2 
DESCRIPTION 
Comm reads file/ and file2, which should be sorted, and produces a three column output: lines 
only in file/; lines only in file2; and lines in both files. The filename ‘—’ means the standard in- 
put. 


Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm —12 prints only 
the lines common to the two files; comm —23 prints only lines in the first file but not in the 
second; comm —123 1s a no-op. 


SEF ALSO 
cmp (I), diff (1) 


BUGS 
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NAME 
cp — copy 


SYNOPSIS 
ep file! file2 


DESCRIPTION 7 ) 
The first file is copied onto the second. The mode and owner of the target file are ¢ preserved if 
it already existed; the mode of the source file is used otherwise. 


If file2 is a directory, then the target file is a file in that directory with the file-name of /ile/. 
It is forbidden to copy a file onto itself. 


SEE ALSO 
cat (I), pr (1), mv (1) 


BUGS 
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NAME 


cref — make cross reference listing 


SYNOPSIS 


cref | —acilostux123 ] name ... 


DESCRIPTION 


Cref makes a cross reference listing of program files in assembler or C format. The files named 
as arguments in the command line are searched for symbols in the appropriate syntax. 


The output report is in four columns: 


(1) (2) (3) (4) 
symbol file see text as it appears in file 
below 


Cref may use either an ignore file or an only file. If the —i option is given, the next argument is 
taken to be an /gnore file; if the —o option is given, the next argument is taken to be an onl; 
tite. /ynore and only files are lists of symbols separated by new lines. All symbols in an ignore 
Ale are ignored in columns (1) and (3) of the output. If an ovi/y file is given, only symbols in 
that file appear in column (1). At most one of —i and —o may be used. The default setting is 
—i. Assembler predefined symbols or C keywords are ignored. 


The —s option causes current symbols to be put in column 3. In the assembler, the current 
symbol is the most recent name symbol; in C, it is the current function name. The —! option 
causes the line number within the file to be put in column 3. 


The —t option causes the next available argument to be used as the name of the intermediate 
temporary file (instead of /tmp/crt??). The file is created and is not removed at the end of the 
process. The format of the output under this option ts not as above. 


Options: 

a assembler format (default) 

ec C format input 

i use ignore file (see above) 

1 put line number in col. 3 (instead of current symbol) 

o use viily file (see above) 

Ss current symbol in col. 3 (default) 

t user supplied temporary file 

u__ print only symbols that occur exactly once 

Xx print only C external symbols | 

1 sort output on column 1 (default) 

2 sort output on column 2 

3 sort output on column 3 

FILES 
/‘imp/ert?? temporaries 
/usr/lib/aign default assembler /vnore file 
/usr/lib/cign | _ default C ignore file 
/usr/bin/crpost post processor 
/usr/bin/upost post processor for —u option 
/bin/sort used to sort temporaries 
SEE ALSO 


BUGS 


as (1), ce (1) 
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NAME | 
date — print and set the date 


SYNOPSIS 
date [ mmddhhmmlyy] ] 


DESCRIPTION 
If no argument is given, the current date is printed to the second. If an argument is 
given, the current date is set. The first mm is the month number, dd is the day 
number in the month; AA is the hour number (24 hour system); the second mm is the 
minute number; yy is the last 2 digits of the year number and is optional. For exam- 
pie: 
date 10080045 


sets the date to Oct 8, 12:45 AM. The current year is the default if no year is men- 
tioned. The system operates in GMT. Date takes care of the conversion to and from 
iocal standard and daylight time. | 


BUGS 
It is difficult to remain current with the rules for DST. 
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db — debug 


SYNOPSIS 


db [ core [ namelist ] ] [ — ] 


DESCRIPTION 
Unlike many debugging packages db is not loaded as part of the core image which it is used to 
examine; instead it examines files. Typically, the file will be either a core image produced after 
a fault or the binary output of the assembler. Core is the file being debugged; if omitted core is 
assumed. Namelist is a file containing a symbol table. If it is omitted, the symbol table is ob- 
tained from the file being debugged, or if not there from a.out. If no appropriate name list file 
can be found, dbcan still be used but some of its symbolic facilities become unavailable. 


For the meaning of the optional third argument, see the last paragraph below. 


The format for most db requests is an address followed by a one character command. Ad- 
dresses are expressions built up as follows: 


l. 


A name has the value assigned to it when the input file was assembled. It may be relocat- 
able or not depending on the use of the name during the assembly. 


An octal number is an absolute quantity with the appropriate value. 


bs] 


A decimal number immediately followed by ‘. 


is an absolute quantity with the appropriate 
value. 


An octal number immediately followed by r is a relocatable quantity with the appropriate 
value. 


The symbol . indicates the current pointer of «/b. The current pointer is set by many <b re- 
quests. 


A * before an expression forms an expression whose value is the number in the word ad- 
dressed by the first expression. A * alone is equivalent to ‘*.’. 


. Expressions separated by + or blank are expressions with value equal to the sum of the 


9. 
Names for registers are built in: 


r0... 


components. At most one of the components may be relocatable. 


Expressions separated by — form an expression with value equal to the difference between 
the components. If the right component is relocatable, the left component must be relocat- 
able. 


Expressions are evaluated left to right. 


r5 


sp 


pe 


frO ... fr5 


These may be examined. Their values are deduced from the contents of the stack in a core im- 
age file. They are meaningless in a file that is not a core image. 


ee 99 


If no address is given for a command, the current address (also specified by ‘‘.’*) is assumed. 
In general, ‘*.*’ points to the last word or byte printed by db. 


There are db commands for examining locations interpreted as numbers, machine instructions, 
ASCII characters, and addresses. For numbers and characters, either bytes or words may be 
examined. The following commands are used to examine the specified file. 


/ The addressed word is printed in octal. 


\. The addressed byte is printed in octal. 
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The addressed word is printed as two ASCII characters. 
The addressed byte is printed as an ASCII character. 
The addressed word is printed in decimal. 


” The addressed word is interpreted as a machine instruction and a symbolic form of the in- 
struction, including symbolic addresses, is printed. Often, the result will appear exactly as 
it was written in the source program. 


& The addressed word is interpreted as a symbolic address and is printed as the name of the 
‘symbol whose value is closest to the addressed word, possibly followed by a signed offset. 


<nl> (i. e., the character ‘‘new line’’). This command advances the current location counter 
‘*.”’ and prints the resulting location in the mode last specified by one of the above re- 
quests. pO 


6e¢ 99 


This character decrements ‘‘.’’ and prints the resulting location in the mode last selected by 
one of the above requests. It is a converse to <nl>. 


‘“: Exit. 


Odd addresses to word-oriented commands are rounded down. The incrementing and decre- 
menting of ‘‘."’ done by the <nl> and ~ requests is by one or two depending on whether the 
last command was word or byte oriented. 


The address portion of any of the above commands may be followed by a comma and then by 
an expression. In this case that number of sequential words or bytes specified by the expression 


oe 99 


Is printed. ‘*.”’ is advanced so that it points at the last thing printed. 
There are two commands to interpret the value of expressions. 


== When preceded by an expression, the value of the expression is typed in octal. When not 
preceded by an expression, the value of ‘‘.’’ is indicated. This command does not change 
the value of **.’. | 


An attempt is made to print the given expression as a symbolic address. If the expression 
is relocatable, that symbol is found whose value is nearest that of the expression, and the 
symbol is typed, followed by u sign and the appropriate offset. If the value of the expres- 
sion iS absolute, a symbol with exactly the indicated value is sought and printed if found, if 
nce matching symbol is discovered, the octal value of the expression Is given. 


= tullowing command may be used to patch the file being debugged. 


= 
x 
a 


! This command must be preceded by an expression. The value of the expression is stored 
at the location addressed by the current value of **..’. The opcodes do not appear in the 


symbol table, so the user must assemble them by hand. | | 
The following command is used after a fault has caused a core image file to be produced. 


> causes the fault type and the contents of the general registers and several other registers to 
be printed both in octal and symbolic format. The values are as they were at the time of 
the fault. 


For some purposes, it iS Important to know how addresses typed by the user correspond with 
locations in the file being debugged. Te mapping algorithm employed by dé is non-trivial for 
two reasons: First, in an a.out file, there is a 20(8) byte header which will not appear when the 
file is loaded into core for execution. Therefore, apparent location 0 should correspond with ac- 
tual file offset 20. Second, addresses in core images do not correspond with the addresses used 
by the program because in a core image there is a header containing the system’s per-process 
data for the dumped process, and also because the stack is stored contiguously with the text and 
data part of the core image rather than at the highest possible locations. D6 obeys the following 
rules: . 


If exactly one argument is given, and if it appears to be an a.out file, the 20-byte header is 
Skipped during addressing, i.e., 20 1s added to all addresses typed. As a consequence, the 
header can be examined beginning at location —20. 
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If exactly one argument is given and if the file does not appear to be an a.out file, no mapping 
is done. 


If zero or two arguments are given, the mapping appropriate to a core image file is employed. 
This means that locations above the program break and below the stack effectively do not exist 
(and are not, in fact, recorded in the core file). Locations above the user’s stack pointer are 
mapped, in looking at the core file, to the place where they are really stored. The per-process 
data kept by the system, which is stored in the first part of the core file, cannot currently be ex- 
amined (except by §$). 


If one wants to examine a file which has an associated name list, but is not a core image file, 
the last argument ‘‘—’’ can be used (actually the only purpose of the last argument is to make 
the number of arguments not equal to two). This feature is used most frequently in examining 
the memory file /dev/mem. 


SEE ALSO 


as (I), core (V), a.out (V), od (I) 


DIAGNOSTICS 


BUGS 


‘‘File not found”’ if the first argument cannot be read; otherwise ‘*?”’. 


There should be some way to examine the registers and other per-process data in a core image, 
also there should be some way of specifying double-precision addresses. It does not know yet 
about shared text segments. 
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NAME 
dc — desk calculator 


SYNOPSIS 
de [ file i 


DESCRIPTION 
De is an arbitrary precision arithmetic package. Ordinarily it operates on decimal integers, but 
one may specify an input base, output base, and a number of fractional digits to be maintained. 
The overall structure of dc is a stacking (reverse Polish) calculator. If an argument is given, in- 
put is taken from that file until its end, then from the standard input. The following construc- 
tions are recognized: | 


number 
The value of the number is pushed on the stack. A number is an unbroken string of the 
digits 0-9. It may be preceded by an underscore _ to input a negative number. Numbers 
may contain decimal points. | 


+-* % ° 
The top two values on the stack are added (+), subtracted (—), multiplied (*), divided 
(/), remaindered (‘%), or exponentiated (*). The two entries are popped off the stack; 
the result is pushed on the stack in their place. Any fractional part of an exponent is ig- 
nored. 


Sx The top of the stack is popped and stored into a register named x, where x may be any 
character. If the s is capitalized, x is treated as a stack and the value is pushed on it. 


Ly The value in register 1 is pushed on the stack. The register x is not altered. All registers 
— gtart with zero value. If the | is capitalized, register x is treated as a stack and its top 
value 1S popped onto the main stack. 


d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains unchanged. 

f All values on the stack and in registers are printed. 

q exits the program. If executing a string, the recursion level is popped by two. If q is 
capitalized, the top value on the stack is popped and the string execution level is popped 
by that value. 

x treats the top element of the stack as a character string and executes it as a string of dc 


commands. 
[ ... ] puts the bracketed ascii string onto the top of the stack. 


<N >x =x 
The top two elements of the stack are popped and compared. Register x is executed if 
they obey the stated relation. 


v replaces the top element on the stack by its square root. Any existing fractional part of 
| the argument is taken into account, but otherwise the scale factor is ignored. 


: interprets the rest of the line as a UNIX command. 


Cc All values on the steck are popped. 
i The top value on the stack is popped and used as the number radix for further input. 
0 The top value on the stack is popped and used as the number radix for further output. 


the top of the stack is popped, and that value is used as a non-negative scale factor: the 
appropriate number of places are printed on output, and maintained during multiplica- 
tion, division, and exponentiation. The interaction of scale factor, input base, and out- 
put base will be reasonable if all are changed together. 
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Z The stack level is pushed onto the stack. 
? A line of input is taken from the input source (usually the console) and executed. 
An example which prints the first ten values of n! is 

[lal+dsa*pla10> ylsy 

Osal 

lyx 


SEE ALSO 
be (I), which is a preprocessor for dc providing infix notation and a C-like syntax which imple- 
ments functions and reasonable control structures for programs. 


DIAGNOSTICS 
(x) ? for unrecognized character x. 
(x) ? for not enough elements on the stack to do what was asked by command x. 
‘Out of space’ when the free list is exhausted (too many digits). 
‘Out of headers’ for too many numbers being kept around. 
‘Out of pushdown’ for too many items on the stack. 
‘Nesting Depth’ for too many levels of nested execution. 


BUGS 
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- NAME 


dd — convert and copy a file 


SYNOPSIS 


dd [option=value] ... 


DESCRIPTION 


Dd copies the specified input file to the specified output with possible conversions. The stan- 
dard input and output are used by default. The input and output block size may be specified to 
take advantage of raw physical I/O. | 


option values 

if= input file name; standard input is default 

of= output file name; standard output is default 

ibs= input block size (default 512) 

obs= output block size (default 512) 

bs= set both input and output block size, superseding ibs and obs; also, if no 
conversion is specified, it is particularly efficient since no copy need be done 

cbs=n conversion buffer size 

skip=n skip ” input records before starting copy 

count=n copy only nv input records 


conv=ascii | convert EBCDIC to ASCII 
ebcdic convert ASCII to EBCDIC 


Icase map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 

noerror do not stop processing on an error 
sync pad every input record to ibs 


re several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. A number may end with k, b or w to 
specify multiplication by 1024, 512, or 2 respectively. Also a pair of numbers may be separated 
by x to indicate a product. 


Cbs is used only if ascii or ebcdic conversion is specified. In the former case cbs characters are 
placed into the conversion buffer, converted to ASCII, and trailing blanks trimmed and new- 
line added before sending the line to the output. In the latter case ASCII characters are read 
into the conversion buffer, converted to EBCDIC, and blanks added to make up an output 
record of size cbs. 


After completion, dd reports the number of whole and partial input and output blocks. 


For example, to read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record into 
the ASCII file x: 


dd if=/dev/rmt0 of=x ibs=800 cbs=80 conv=ascii,lcase 


Note the use of raw magtape. Dd is especially suited to I/O on the raw physical devices because 
it allows reading and writing in arbitrary record sizes. 


SEE ALSO 


BUGS 


cp (I) 


The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the CACM 
Nov, 1968. It is not clear how this relates to real life. 


Newlines are inserted only on conversion to ASCII; padding is done only on conversion to 
EBCDIC. There should be separate options. 
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NAME 
diff — differential file comparator 
SYNOPSIS 
diff [ —12 ] name! name2 
DESCRIPTION 


Diff tells what lines must be changed in two files to bring them into agreement. If either file is 
a directory, then a file in that directory whose file-name is the same as the file-name of the oth- 
er file is used instead. The normal output contains lines of these forms: 


nlan3,n4 
ni,n2dn3 
ni,n2cn3,n4 


These lines resemble ed commands to convert file name/ into file name2. The numbers after 
the letters pertain to file name2. In fact, by exchanging ‘a’ for ‘d’ and reading backward one 
may ascertain equally how to convert file »ame2 into namel. As in ed, identical pairs where n/ 
= 2 or n3 = n4are abbreviated as a single number. 


Following each of these lines come all the lines that are affected in the first file flagged by ‘<’, 
then all the lines that are affected in the second file flagged by ‘>’. 


Under the —1 option, the output of diffis a script of a, c and d commands for the editor ed, 
which will recreate file name/ from file name2, and vice versa under the —2 option. In this 
connection, the following shell program may help maintain multiple versions of a file. Only an 
ancestral file ($1) and a chain of version-to-version ed scripts ($2,$3,...) made by diffneed be 
on hand. A ‘latest version’ appears on the standard output. 


(cat $2 ... $9; echo "1,$p") | ed — $1 
Except for occasional ‘jackpots’, dif finds a smallest sufficient set of file differences. 


SEE ALSO 
cmp (I), comm (1), ed (I) 


DIAGNOSTICS 
‘jackpot’ — To speed things up, the program uses hashing. You have stumbled on a case where 
there is a chance that this has resulted in a difference being called where none actually existed. 
Sometimes reversing the order of files will make a jackpot go away. 


BUGS 
Editing scripts produced under the — option are naive about creating lines consisting of a single 
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NAME 


dsw — delete interactively 


SYNOPSIS 
dsw [ directory |] 


DESCRIPTION 7 , ; | 7 | | | 
For each file in the given directory (‘.’ if not specified) dsw types its name. If y is typed, the 
file is deleted; if x, dsw exits; if new-line, the file is not deleted; if anything else, dsw asks again. 


SEE ALSO 
rm (I) 


BUGS 
The name dsw is a carryover from the ancient past. 
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NAME 
du — summarize disk usage 


SYNOPSIS 
du {[ -s] [ —a] [ name... ] 


DESCRIPTION 
Du gives the number of blocks contained in all files and (recursively) directories within each 
specified directory or file name. If name is missing, *.’ is used. 


The optional argument —s causes only the grand total to be given. The optional argument —a 
causes an entry to be generated for each file. Absence of either causes an entry to be generated 
for each directory only. 


A file which has two links to it is only counted once. 


BUGS 
Non-directories given as arguments (not under —a option) are not listed. 


Removable file systems do not work correctly since i-numbers may be repeated while the 
corresponding files are distinct. Dw should maintain an i-number list per root directory encoun- 
tered. : 
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NAME 
echo — echo arguments 
SYNOPSIS 
echo [ arg ... ] 
DESCRIPTION 


Echo writes its arguments in order as a line on the standard output file. It is mainly useful for 
producing diagnostics in command files. 


If the last character of a line to be echoed is followed by a space (which must be quoted) then 
the echoed line will not be followed by a newline. | 


BUGS 
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NAME 
ed — text editor 


SYNOPSIS 
ed [ — ] [name ] 


DESCRIPTION 
Ed is the standard text editor. 


If a name argument is given, ed simulates an e command (see below) on the named file; that is 
to say, the file is read into ed's buffer so that it can be edited. The optional — suppresses the 
printing of character counts by e, r, and w commands. 


Ed operates on a copy of any file it is editing, changes made in the copy have no effect on the 
file until a w (write) command is given. The copy of the text being edited resides in a tem- 
porary file called the buffer. There is only one buffer. 


Commands to ed have a simple and regular structure: zero or more addresses followed by a sin- 
gle character command, possibly followed by parameters to the command. These addresses 
specify one or more lines in the buffer. Every command which requires addresses has default 
addresses, so that the addresses can often be omitted. 


In general, only one command may appear on a line. Certain commands allow the input of ° 
text. This text is placed in the appropriate place in the buffer. While ed is accepting text, it is 
said to be in iput mode. In this mode, no commands are recognized; all input is merely collect- 
ed. Input mode is left by typing a period ‘.’ alone at the beginning of a line. 


Ed supports a limited form of regular expression notation. A regular expression specifies a set of 
strings of characters. A particular regular expression maiches a string of characters when a line 
of text can be found that contains one of the desired character strings. The regular expressions 
allowed by ed are constructed as follows: 


1. An ordinary character (not one of those discussed below) is a regular expression and 
matches that character. 


2. A circumflex ‘”* at the beginning of a regular expression matches the empty string at the be- 
ginning of a line. 7 


3. A currency symbol ‘$’ at the end of a regular expression matches the null character at the 
end of a line. 


4. A period ‘.’ matches any character except a new-line character. 


5. A regular expression followed by an asterisk *** matches any number of adjacent occurrences 
(including zero) of the regular expression it follows. 


6. A String of characters enclosed in square brackets ‘[ ]° matches any character in the string 
but no others. If, however, the first character of the string is a circumflex *’, the regular 
expression matches any character except new-line and the characters in the string. 


7. The concatenation of regular expressions is a regular expression which matches the concate- 
nation of the strings matched by the components of the regular expression. 


8. A regular expression enclosed between the sequences ‘\(° and ‘\)’is identical to the una- 
dorned expression; the construction has side effects discussed under the s command. 


9. The null regular expression standing alone is equivalent to the last regular expression en- 
countered. | 


Regular expressions are used in addresses to specify lines and in one command (see 4 below) to 
specify a portion of a line which is to be replaced. If it is desired to use one of the regular ex- 
pression metacharacters as an ordinary character, that character may be preceded by ‘\’. This 
also applies to the character bounding the regular expression (often ‘/’) and to ‘\’ itself. 
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To understand addressing in ed it is necessary to know that at any time there is a current line. 
Generally speaking, the current line is the last line affected by a command; however, the exact 
effect on the current line is discussed under the description of the command. Addresses are 
constructed as follows. 


1. The character ‘.’ addresses the current line. 

2. The character ‘$° addresses the last line of the buffer. 

3. A decimal number w addresses the /-th line of the buffer. 
4 


‘‘x’ addresses the line marked with the mark name character x, which must be a lower- 
case letter. Lines are marked with the A command described below. 


5. A regular expression enclosed in slashes ‘/’ addresses the first line found by searching to- 
ward the end of the buffer and stopping at the first line containing a string matching the 
regular expression. If necessary the search wraps around to the beginning of the buffer. 


6. A regular expression enclosed in queries ‘?” addresses the first line found by searching 
toward the beginning of the buffer and stopping at the first line containing a string 
matching the regular expression. If necessary the search wraps around to the end of the 
buffer. 


7. An address followed by a plus sign ‘+’ or a minus sign ‘—’ followed by a decimal number 
specifies that address plus (resp. minus) the indicated number of lines. The plus sign 
may be omitted. | 


8. If an address begins with ‘+’ or ‘—’ the addition or subtraction is taken with respect to 
the current line, e.g. ‘—5° is understood to mean ‘.—S’. 


9. If an address ends with ‘+° or ‘—’, then 1 is added (resp. subtracted). As a consequence 
of this rule and rule 8, the address ‘—* refers to the line before the current line. Moreo- 
ver. trailing ‘+° and ‘—’ characters have cumulative effect, so ‘—-—’ refers to the current 
line less 2. 


oa9 


10.To maintain compatibility with earlier versions of the editor, the character in ad- 


dresses is entirely equivalent to ‘—’. 


Communds may require zero, one, or two addresses. Commands which require no addresses 
regard the presence of an address as an error. Commands which accept one or two addresses 
assume default addresses when insufficient are given. If more addresses are given than such a 
command requires, the last one or two (depending on what is accepted) are used. 


Addresses are separated from each other typically by a comma ‘,’. They may also be separated 
by a semicolon ‘;’. In this case the current line is set to the previous address before the 
next address is interpreted. This feature can be used to determine the starting line for forward 
and backward searches (‘/°, *?’). The second address of any two-address sequence must 


correspond to a line following the line corresponding to the first address. 


e 


In the following list of ed commands, the default addresses are shown in parentheses. The 
parentheses are not part of the address, but are used to show that the given addresses are the 
default. 


As mentioned, it is generally illegal for 1..ore than one command to appear on a line. However, 
any command may be suffixed by ‘p’ or by ‘I’, in which case the current line is either printed or 
listed respectively in the way discussed below. 


(.)a 
<text> 

The append command reads the given text and appends it after the addressed line. ‘.’ is 
left on the last line input, if there were any, otherwise at the addressed line. Address ‘0° 
is legal for this command; text is placed at the beginning of the buffer. 
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eee 
<text> 


The change command deletes the addressed lines, then accepts input text which replaces 
these lines. ‘.’ is left at the last line input; if there were none, it is left at the first line not 
deleted. 


( ege ) d 
The delete command deletes the addressed lines from the buffer. The line originally after 
the last line deleted becomes the current line; if the lines deleted were originally at the 
end, the new last line becomes the current line. 


e filename 
The edit command causes the entire contents of the buffer to be deleted, and then the 
named file to be read in. ‘.’ is set to the last line of the buffer. The number of characters 
read is typed. ‘filename’ is remembered for possible use as a default file name in a subse- 
quent + or wcommand. 


f filename 
The filename command prints the currently remembered file name. If ‘filename’ is given, 
the currently remembered file name is changed to ‘filename’. 


(1,$) g/regular expression/command list 
In the global command, the first step is to mark every line which matches the given regu- 
lar expression. Then for every such line, the given command list is executed with *.° ini- 
tially set to that line. A single command or the first of multiple commands appears on the 
same line with the global command. All lines of a multi-line list except the last line must 
be ended with ‘\’. The a, i, and « commands and associated input are permitted; the *.’ 
terminating input mode may be omitted if it would be on the last line of the command 


list. The (global) commands, g and y, are not permitted in the command list. 


( ° yt 
<text> 

This command inserts the given text before the addressed line. *.’ is left at the last line 
input; if there were none, at the addressed line. This command differs from the a com- 
mand only in the placement of the text. 


(.)kyx 
The mark command marks the addressed line with name 1, which must be a lower-case 
letter. The address form ‘x then addresses this line. 


ern 9 | 
The list command prints the addressed lines in an unambiguous way: non-graphic charac- 
ters are printed in octal, and long lines are folded. An /command may follow any other 
on the same line. 


(.,.)ma 
The move command repositions the addressed lines after the line addressed by a. The 
last of the moved lines becomes the current line. 


(.,.)p 
The print command prints the addressed lines. is left at the last line printed. The p 
command may be placed on the same line after any command. 


« 9 


q 
The quit command causes ed to exit. No automatic write of a file is done. 


($) r filename 
The read command reads in the given file after the addressed line. If no file name is 
given, the remembered file name, if any, is used (see « and /commands). The remem- 
bered file name is not changed unless ‘filename’ is the very first file name mentioned. 
Address ‘0’ is legal for r and causes the file to be read at the beginning of the buffer. If 
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the read is successful, the number of characters read is typed. *.’ is left at the last line 
read in from the file. 


. )s/regular expression/replacement/ or, 
. )s/regular expression/replacement/g 


The substitute command searches each addressed line for an occurrence of the specified 
regular expression. On each line in which a match is found, all matched strings are re- 
placed by the replacement specified, if the global replacement indicator ‘g’ appears after 
the command. If the global indicator does not appear, only the first occurrence of the 
matched string is replaced. It is an error for the substitution to fail on all addressed lines. 
Any character other than space or new-line may be used instead of ‘/° to delimit the regu- 
lar expression and the replacement. ‘.’ is left at the last line substituted. 


An ampersand *&’ appearing in the replacement is replaced by the string matching the 


regular expression. The special meaning of ‘&’ in this context may be suppressed by 


preceding it by ‘\’. As a more general feature, the characters ‘\’, where » is a digit, are 
replaced by the text matched by the w-th regular subexpression enclosed between ‘\(’ and 
‘\)’. When nested. parenthesized SU DEXPIGSstONS are present, IS determined by counting 
occurrences of ‘\(" starting from the left. 


Lines may be split by substituting new-line characters into them. The new-line in the re- 
placement string must be escaped by preceding it by ‘\’. 


ta 


This command acts just like the # command, except that a copy of the addressed lines is 
placed after address w (which may be 0). ‘.° is left on the last line of the copy. 


v/regular expression/command list 
This command is the same as the global command except that the command list is execut- 
ed with *.° initially set to every line except those matching the regular expression. 


w filename 

The write command writes the addressed lines onto the given file. If the file does not ex- 
ist, it is created mode 666 (readable and writeable by everyone). The remembered file 
name is voi changed unless ‘filename’ is the very first file name mentioned. If no file 
name is given, the remembered file name, if any, is used (see ec and f/commands). ‘.’ is 
unchanged. If the command is successful, the number of characters written is typed. 


‘ 9 


The line number of the addressed line IS typed. ‘.’ is unchanged by this command. 


'UNIX command 


Cal 


If an 


The remainder of the line after the ‘! is sent to UNIX to be interpreted as a command. 


. iS unchanged. 


) <newline> 
An address alone on a line causes oe addressed line to be srmied. A blank line alone is 
equivalent to ‘.+1p’; it is useful for stepping through text. 


interrupt signal (ASCII DEL) is sént, ed prints a ‘?’ and returns to its command level. 


The following size limitations apply: 512 characters per line, 256 characters per global command 
list, 64 characters per file name, and 128K characters in the temporary file. The limit on the 
number of lines depends on the amount of core: each line takes | word. 


FILES 


/tmp/#, temporary; *#° is the process number (in octal). 


DIAGNOSTICS 
‘?° for errors in commands; “TMP! for temporary file overflow. 


SEE ALSO 


A Tutorial Introduction to the ED Text Editor (B. W. eine 
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BUGS 
The s command causes all marks to be lost on lines changed. 
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NAME 
exit — terminate command file 


SYNOPSIS 
exit [ rtncode ] 


DESCRIPTION 
Exit performs a seek to the end of its standard input file. Thus, if it is invoked inside a file of 
commands, upon return from exit the shell will discover an end-of-file and terminate. The op- 
tional numeric argument rtncode, if given, is used by exit for the return code; otherwise the re- 
turn code is set to 0. 


SEE ALSO 
if (I), goto (I), sh (I) 


BUGS 
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NAME 
fc — Fortran compiler 
SYNOPSIS 
fe [ —c ] sfilel.f ... ofilel ... 
DESCRIPTION 


Fcis the UNIX Fortran compiler. It accepts three types of arguments: 


Arguments whose names end with ‘.f’ are assumed to be Fortran source program units, they 
are compiled, and the object program is left on the file sfilel.o (i.e. the file whose name is that 
of the source with ‘.o” substituted for °.f?). 


Other arguments (except for —c) are assumed to be either loader flags, or object programs, typ- 
ically produced by an earlier fc run, or perhaps libraries of Fortran-compatible routines. These 
programs, together with the results of any compilations specified, are loaded (in the order 
given) to produce an executable program with name a.out. 


The —c argument suppresses the loading phase, as does any syntax error in any of the routines 
being compiled. 


The following is a list of differences between /c and ANSI standard Fortran (also see the BUGS 
section): 
|. Arbitrary combination of types is allowed in expressions. Not all combinations are expect- 


ed to be supported at runtime. All of the normal conversions involving integer. real, dou- 
ble precision and complex are allowed. 


2. Two torms of ‘‘implicit’? statements are recognized: implicit integer /i—n/ or implicit in- 
teger (i—n). 


3. The types doublecomplex, logical*], integer*], integer*2, integer*4 (same as integer), 
real*4 (real), and real*8 (double precision) are supported. 


4. & us the first character of a line signals a continuation card. 
5S. cas the first character of a line signals a comment. 

6. All keywords are recognized in lower case. 

7. The notion of ‘column 7° is not implemented. 
8 


G-format input is free form— leading blanks are ignored, the first blank after the start of 
the number terminates the field. 


9. A comma in any numeric or logical input field terminates the field. 


10. There is no carriage control on output. 


ees 


11. A sequence of » characters in double quotes is equivalent to 7 h followed by those char- 


acters. 


12. In data statements, a hollerith string may initialize an array or a sequence of array ele- 
ments. 


13. The number of storage units requested by a binary read must be identical to the number 
contained in the record being read. 


14. If the first character in an input file is **#°’, a preprocessor identical to the C preprocessor 
is called, which implements ‘‘#define”’ and *‘#include’’ preprocessor statements. (See the 
C reference manual for details.) The preprocessor does not recognize Hollerith strings writ- 
ten with v7. 


In I/O statements, only unit numbers 0-19 are supported. Unit number »v refers to file forts: 
(e.g. unit 9 is file ‘fort09’). For input, the file must exist, for output, it will be created. Unit 5 
is permanently associated with the standard input file; unit 6 with the standard output file. Also 
see sezfil (IIL) for a way to associate unit numbers with named files. 
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FC (1) 
FILES 
| a.out loaded output 

f.tmp[123] temporary (deleted) 
/usr/fort/fel compiler proper 
/lib/fr0.0 runtime startoff 
/lib/filib.a interpreter library 
Alib/libf.a built-in functions, etc. 
/lib/liba.a system library 

SEE ALSO 


PA-1C300-01 

| Section 1 
Issue 1, January 1976 
AT&TCo SPCS 


FC (1) 


ANSI standard, Id (I) for loader flags. For some subroutines, try ierror, getarg, setfil (III). 


DIAGNOSTICS 


Compile-time diagnostics are given in English, accompanied if possible with the offending line 
number and source line with an underscore where the error occurred. Runtime diagnostics are 


given by number as follows: 


invalid log argument 

bad arg count to amod 

bad arg count to atan2 

excessive argument to cabs 

exp too large in cexp 

bad arg count to cmplx 

bad arg count to dim 

excessive argument to exp 

bad arg count to idim 

10 __— bad arg count to isign 

11 bad arg count to mod 

12 bad arg count to sign 

13 illegal argument to sart 

14 = assigned/computed goto out of range 
15 subscript out of range 

16 real**real overflow 

17‘ (negative real)**real 

100 illegal I/O unit number 

101 inconsistent use of I/O unit 

102 cannot create output file 

103 cannot open input file 

104 EOF on input file 

‘105 illegal character in format 

106 format does not begin with ( 

107 no -conversion in format but non-empty list 
108 excessive parenthesis depth in format 
109 illegal format specification 

110 illegal character in input field 

111 end of format in hollerith specification 
112 bad argument to setfil 

120 bad argument to ierror 

999 unimplemented input conversion 


WO CONN AR WD — 


BUGS 


The following is a list of those features not yet imple 


arithmetic statement functions 
scale factors on input 
Backspace statement. 
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NAME 
file — determine format of file 


SYNOPSIS 
file files 


DESCRIPTION 
File will examine each of its arguments and give a guess as to the contents of the file. It is the 
only program that will give device numbers of special files. | 

BUGS 
If the file is not instantly recognized, its type is given as ‘unknown’. There should be some 
heuristic to recognize source file ‘signatures’ in each of the standard languages. 
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NAME 
find — find files 


SYNOPSIS 


Issue 1, January 1976 
AT&TCo SPCS 


FIND (1) 


find pathname expression 


DESCRIPTION 


Find recursively descends the directory hierarchy from pathname seeking files that match a 
boolean expression written in the primaries given below. In the descriptions, the argument n is 
used as a decimal integer where +” means more than n, —n means less than 7” and nm means 


exactly n. 
—name filename 


—perm onum 


—type c 


—links 7 
—user uname 
—size n 
—atime 7 
—mtime 


—exec command 


—ok command 


— print 


True if the filename argument matches the current file name. Normal 
Shell argument syntax may be used if escaped (watch out for ‘[’, ‘?’ 
and ‘*°). 


True if the file permission flags exactly match the octal number onum 
(see chmod (1)). If onum is prefixed by a minus sign, more flag bits 
(017777, see stat (II)) become significant and the flags are compared: 
(flagskonum) = =onum. 


True if the type of the file is c, where c is b, c, d or f for block special 
file, character special file, directory or plain file. 


True if the file has v7 links. 

True if the file belongs to the user wname. 

True if the file is 7 blocks long (512 bytes per block). 
True if the file has been accessed in ” days. 

True if the file has been modified in days. 


True if the executed command returns exit status zero (most com- 
mands do). The end of the command is punctuated by an escaped 
semicolon. A command argument ‘{}’ is replaced by the current path- 
name. 


Like —exec except that the generated command line is printed with a 
question mark first, and is executed only if the user responds y. 


Always true; causes the current pathname to be printed. 


The primaries may be combined with these operators (ordered by precedence): 


' 
—a 
—oO 


( expression ) 


prefix nor 
infix and, second operand evaluated only if first is true 
infix or, second operand evaluated only if first is false 


parentheses for grouping. (Must be escaped.) 


To remove files named ‘a.out’ and ‘*.o° ot accessed for a week: 


find /"(" —name a.out —o —name "*.0" ")" —a —atime +7 —a —exec rm {}": 


wit 


FILES 

/etc/passwd 
SEE ALSO 

sh (1), if (1), file system (V) 
BUGS 


There is no way to check device type. 
Syntax should be reconciled with if 
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NAME 
goto — command transfer 


SYNOPSIS 
goto label 


DESCRIPTION 
Goto is allowed only when the Shell is taking commands from a file. The file is searched from 
the beginning for a line beginning with ‘:’ followed by one or more spaces followed by the /abel. 
If such a line is found, the gofo command returns. Since the read pointer in the command file 
points to the line after the label, the effect is to cause the Shell to transfer to the labelled line. 


Note that to the Shell, any line beginning with a ‘:’ is a comment. 


SEE ALSO 
sh (1) 


BUGS 
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NAME 
grep — search a file for a pattern 
SYNOPSIS 
grep [—v] [—b] [ —c] [ —n ] expression [ file ] ... 
DESCRIPTION 


Grep searches the input files (standard input default) for lines matching the regular expression. 
Normally, each line found is copied to the standard output. If the —v flag is used, all lines but 
those matching are printed. If the —c flag is used, only a count of matching linés is‘printed. If 
the —n flag is used, each line is preceded by its relative line number in the file. If the —b flag 
is used, each line is preceded by the block number on which it was found. This is sometimes 
useful in locating disk block numbers by context. | 


In all cases the file name is shown if there is more than one input file. 


For a complete description of the regular expression, see ed (1). Care should be taken when 
using the characters $ * [*|() and \ in the regular expression as they are also meaningful to 
the Shell. It is generally necessary to enclose the entire expression argument in double quotes. 


SEE ALSO 
ed (I), sh (I) 


BUGS 
Lines are limited to 256 characters; longer lines are truncated. 
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IF (1) | IF (1) 


NAME 
if — conditional command 


SYNOPSIS 
if expr command [ arg ... ] 


DESCRIPTION | 
[f evaluates the expression expr, and if its value is true, executes the given command with the 
given arguments. 


The following primitives are used to construct the expr: 


—r file true if the file exists and is readable. 

—w file true if the file exists and is writable. 

sl = s2 true if the strings s/ and s2 are equal. 

sl != s2 true if the strings s/ and s2 are not equal. 


{ command } [n] The bracketed command is executed to obtain the exit status. Status 
| zero 1S considered true. The command must not be another if The 
optional n is a valid condition code (0 = success, 4 = partial failure, 8 

= total failure) When used, status <= n is considered to be true. 


These primaries may be combined with the following operators: 


: unary negation operator 
—a binary and operator 

—0O binary or operator 

( expr ) parentheses for grouping. 


~—a has higher precedence than —o. Notice that all the operators and flags are separate argu- 
ments to if and hence must be surrounded by spaces. Notice also that parentheses are mean- 
ingful to the Shell and must be escaped. 


SEE ALSO 
sh (I), exit UD 


BUGS 
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NAME 
kill — terminate a process 


SYNOPSIS 
kill [ —sig ] processid ... 


DESCRIPTION 
Kills the specified processes. The process number of each asynchronous process started with 
‘&’ is reported by the Shell. Process numbers can also be found by using ps (I). 


If process number 0 is used, then all processes belonging to the current user and associated 
with the same control typewriter are killed. 


The killed process must belong to the current user unless he is the super-user. 


If a signal number preceded by ‘‘—’” is given as first argument, that signal is sent instead of ki// 
(see signal (11). 


SEE ALSO 
ps (I), sh (1), signal (II) 


BUGS 
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NAME 
lc — LIL compiler 
SYNOPSIS 
Ice{-c] [—p][—P] file ... 
DESCRIPTION 


Lc is the UNIX LIL compiler. It accepts three types of arguments: 


Arguments whose names end with *.l’ are taken to be LIL source programs; they are compiled, 
and each object program is left on the file whose name is that of the source with ‘.o’ substituted 
for ‘1’. The ‘.o’ file is normally deleted, however, if a single LIL program is compiled and 
loaded all at one go. 


The following flags are interpreted by /c. See /d (I) for load-time flags. 


—c Suppress the loading phase of the compilation, and force an object file to be produced 
even if only one program is compiled. 


—p Arrange for the compiler to produce code which counts the number of times each 
routine is called; also, if loading takes place, replace the standard startup routine by one 
which automatically calls the monitor (III) subroutine at the start and arranges to write 
out a mon.out file at normal termination of execution of the object program. An execu- 
tion profile can then be generated by use of prof (I). 


—P Run only the macro preprocessor on the named LIL programs, and leave the output on 
corresponding files suffixed ‘.i’. 


Other arguments are taken to be either loader flag arguments, or LIL-compatible object pro- 
grams, typically produced by an earlier /c run, or perhaps libraries of LIL-compatible routines. 
These programs, together with the results of any compilations specified, are loaded (in the ord- 
er given) to produce an executable program with name a.out. 


FILES ; 
file.1 input file 
file.o object file 
a.out loaded output 
/tmp/ctm0? temporary 
/usr/lib/lil[12] compiler 
/lib/liba.a Assembler library 
SEE ALSO 
monitor (III), prof (I), Id (1). 
DIAGNOSTICS 


The diagnostics produced by LIL itself are intended to be self-explanatory. 


BUGS 
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LD (1) 


Id — link editor 


SYNOPSIS 


id { —sulxXrdni ] name ... 


DESCRIPTION 


Ld combines several object programs into one; resolves external references; and searches li- 
braries. In the simplest case the names of several object programs are given, and /d combines 
them, producing an object module which can be either executed or become the input for a 
further /drun. (In the latter case, the —r option must be given to preserve the relocation bits.) 


The output of /dis left on a.out. This file is rnade executable only if no errors occurred during 


the load. 


The argument routines are concatenated in the order specified. The entry point of the output is 
the beginning of the first routine. 


If anv argument is a library, it 1s searched exactly once at the point it is encountered in the ar- 
gument list. Only those routines defining an unresolved external reference are loaded. If a 
routine from a library references another routine in the library, the referenced routine must ap- 
pear after the referencing routine in the library. Thus the order of programs within libraries is 
important. a | 


¢ > 


Ld understands several flag arguments which are written preceded by a ‘—’. Except for —l, 
they should appear before the file names. 


—s ‘strip’ the output; that is, remove the symbol table and relocation bits to save space (but 
impair the usefulness of the debugger). This information can also be removed by svrip. 


—u take the following argument as a symbol and enter it as undefined in the symbol table. 
This is useful for loading wholly from a library, since initially the symbol table is empty and 
an unresolved reference is needed to force the loading of the first routine. 


—1 This option is an abbreviation for a library name. —1] alone stands for ‘/lib/liba.a’, which is 
the standard system library for assembly language programs. —Ix stands for ‘/lib/libx.a’ 
where x is any character. A library is searched when its name is encountered, so the place- 
ment of a —l1 is significant. | 


—x do not preserve local (non-.globl) symbols in the output symbol table, only enter external 
svmbols. This option saves some space in the output file. 


—X Save local symbols except for those whose names begin with ‘L’. This option is used by cc 
to discard internally generated labels while retaining symbols local to routines. 


—r generate relocation bits in the output file so that it can be the subject of another /d run. ° 
This flag also prevents final definitions from being given to common symbols, and 
suppresses the ‘undefined symbol’ diagnostics. 


—d force definition of common storage even if the —r flag is present. 


—n Arrange that when the output file is executed, the text (program) portion will be read-only 
and shared among all users executing the file. This involves moving the data areas up to 
the first possible 4K word boundary tullowing the end of the text. 


—i When the output file is executed, the program text and data areas will live in separate ad- 
dress spaces. The only difference between this option and —n is that here the data starts at 


location Q. 
FILES . 
/lib/lib?.a = libraries 
a.out output file 
SEE ALSO 


arcv (I), as (I), ar (I) 
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DIAGNOSTICS 
archive-name: old archive format! 
The archive "archive—name" is still in old archive format. The loader will handle this 


properly; however, program arcv should be used to convert this archive to the new ar- 
chive format. 


BUGS 
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LN (1) 


In — make a link 


SYNOPSIS 


In name! [ name2 ] 


DESCRIPTION 


A link is a directory entry referring to a file; the same file (together with its size, all its protec- 
tion information, etc) may have several links to it. There is no way to distinguish a link to a 
file from its original directory entry; any changes in the file are effective independently of the 
name by which the file is known. 


Ln creates a link to an existing file name/. If name2 is given, the link has that name; otherwise 
it is placed in the current directory and its name is the last component of name. 


It is forbidden to link to a directory or to link across file systems. 


SEE ALSO 


BUGS 


rm (I) 


Tp doesn’t understand about links and makes one copy for each name by which a file is known; 
thus if the tape is extracted, several copies are restored and the information that links were in- 
volved is lost. | | 

If name2 is a directory, /1 should make a link to the file name/ in that directory with the name 
name], 
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NAME 
login — sign onto UNIX 


SYNOPSIS 
login { username ] 


DESCRIPTION 
The /ogin command is used when a user initially signs onto UNIX, or it may be used at any 
time to change from one user to another. The latter case is the one summarized above and 
described here. See ‘How to Get Started’ for how to dial up initially. 


If /ogin is invoked without an argument, it asks for a user name, and, if appropriate, a password. 
Echoing is turned off (if possible) during the typing of the password, so it will not appear on 
the written record of the session. 


After a successful login, accounting files are updated and the user is informed of the existence 
of .mail. If the message-of-the-day file, /etc/motd, exists, it is printed on the user’s terminal. 
Login initializes the user and group IDs and the working directory, then executes a command 
interpreter (usually sh (I)) according to specifications found in a password file. 


Login is recognized by the Shell and executed directly (without forking). 


FILES 

/tmp/utmp accounting 

/usr/adm/wtmp accounting 

mail mail 

/etc/motd message-of-the-day 

/etc/passwd password file 
SEE ALSO 

init (VIII), getty (VIII), mail (1), passwd (1), passwd (V) 
DIAGNOSTICS 


‘login incorrect,’ if the name or the password is bad. ‘No Shell,’, ‘cannot open password file,’ 
‘no directory’: consult a UNIX programming counselor. | 


BUGS 
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LPR (1) LPR (1) 
NAME | 

Ipr — line printer spooler 
SYNOPSIS / 

‘tpr{ —] (+11 +—Ifile ... | | 
DESCRIPTION 


Lpr arranges to have the line printer daemon print the file arguments. 


Normally, each file is printed in the state it is found when the line printer daemon reads it. 
Files following a + will be copied before printing. Files following a — will be unlinked (re- 
moved) by /pr after printing. 


If there are no arguments, then the standard input is read and on-line printed. Thus /pr may be 
used as a filter. 


FILES . 
/usr/|pd/* spool area 
/etc/passwd personal ident cards 
/etc/Ipd daemon 

SEE ALSO | 


— Ipd (VII), passwd (V) 
BUGS 


Bell Telephone Laboratories, Incorporated -l- PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section 1 


LS (1) 


NAME 


Issue 1, January 1976 
AT&TCo SPCS 


LS (1) 


Is — list contents of directory 


SYNOPSIS 


ls [ —Itasdruif ] name ... 


DESCRIPTION 


FILES 


BUGS 


For each directory argument, /s lists the contents of the directory; for each file argument, /s re- 
peats its name and any other information requested. The output is sorted alphabetically by de- 
fault. When no argument is given, the current directory is listed. When several arguments are 
given, the arguments are first sorted appropriately, but file arguments appear before directories 
and their contents. There are several options: 


—1 list in long format, giving mode, number of links, owner, size in bytes, and time of last 
modification for each file. (See below.) If the file is a special file, the size field will contain 
the major and minor device numbers instead. 


—t sort by time modified (latest first) instead of by name, as is normal 
—a list all entries; usually those beginning with ‘.’ are suppressed 
—S give size in blocks for each entry 


-—d if argument is a directory, list only its name, not its contents (mostly used with —! to get 
status on directory) 


—r reverse the order of sort to get reverse alphabetic or oldest first as appropriate 
—u use time of last access instead of last modification for sorting (—t) or printing (—1) 
—i print i-number in first column of the report for each file listed 


—f force each argument to be interpreted as a directory and list the name found in each slot. 
This option turns off —l, —t, —s, and —r, and turns on —a; the order is the order in 
which entries appear in the directory. 


The mode printed under the —1 option contains 11 characters which are interpreted as follows: 
the first character is 


if the entry is a directory; 

if the entry is a block-type special file; 

if the entry is a character-type special file; 
if the entry is a plain file. 


The next 9 characters are interpreted as three sets of three bits each. The first set refers to 
owner permissions, the next to permissions to others in the same user-group, and the last to all 
others. Within each set the three characters indicate permission to read, to write, or to execute 
the file as a program, respectively. For a directory, ‘execute’ permission is interpreted to mean 
permission to search the directory for a specified file. The permissions are indicated as follows: 


pore 


if the file is readable; 

if the file is writable; 

if the file is executable; 

if the indicated permission is not granted. 


,p" an 


The group-execute permission character is given as s if the file has set-group-ID mode; like- 
wise, the user-execute permission character is given as s if the file has set-user-ID mode. 


/etc/passwd to get user ID’s for is —1. 
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NAME 


mail — send mail to designated users 


SYNOPSIS 
mail { —yn ] [ person ... ] 


DESCRIPTION 
Mail with no argument searches for a file called .mai/, prints it if it is nonempty, then asks if it 
should be saved. If the answer is y, the mail is added to mbox. Finally .mail.is truncated to 
zero length. To leave .mail, hit ‘delete.’ The question can be answered on the command line 
with the argument ‘—y’ or ‘—n’. 
When persons are named, mail takes the standard input up to an end of file and adds it to each 
person's .mail file. The message is preceded by the sender’s name and a postmark. 


A person is either a user name recognized by /ogin (I), in which case the mail is sent to the ini- 
tial working directory of that user; or the path name of a directory, in which case .mail in that 
directory is used. 


When a user logs in he is informed of the presence of mail. No mail will be received from a 
sender to whom .mail is inaccessible or unwritable. 


FILES 
/tmp/passwd to identify sender and locate persons 
/tmp/utmp to identify sender 
mail input mail 
mbox saved mail 
/tmp/m# temp file 
SEE ALSO 
write (I) 


BUGS 
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NAME 
mesg — permit or deny messages 


SYNOPSIS 
mesg [n][y] 


DESCRIPTION 
Mesg with argument n forbids messages via write by revoking non-user write permission on the 
user’s typewriter. Mesg with argument y reinstates permission. All by itself, mesg reverses the 
current permission. In all cases the previous state is reported. 


FILES 
/dev/tty? 


SEE ALSO 
write (I) 


DIAGNOSTICS 
‘?° if the standard input file is not a typewriter. 


BUGS 
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MKDIR (1) MKDIR (1) 


NAME 
mkdir — make a directory 


SYNOPSIS . 
mkdir dirname ... 


DESCRIPTION — = 
Mkdir creates specified directories in mode 777. The standard entries ‘.’ and ‘..’ are 
made automatically. 


SEE ALSO 
rmdir (I) 


BUGS 
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MTM (1) | MTM (1) 


NAME 
mtm — magnetic tape manipulation 


SYNOPSIS 
mtm (s7] (IJ (bp) (unit) 


DESCRIPTION 
Mtm will help in the processing of multifile magnetic tapes. The optional arguments are: 


sn Forward space the magnetic tape for n files. 


Im Produce a list of the number and sizes of the records on the magnetic tape for m 
files. If mis missing mtm will analyze records upto a double EOT. 


bp Define the maximum record size as pK bytes. If 5 is missing, then the maximum 
record size is assumed to be 2K bytes. 


AS an example, 
mtm s]1 ll 
gives: 


File 2 

Record | - 14 bytes 
Record 2 - 512 bytes 
23 records 


This means that file 2 contains one 14-byte record and twenty two 512-byte records. 


The two arguments can be combined to skip some files, then analyze some number of remain- 
ing files. If neither argument is given, mtm will analyze the entire tape. 


Unu specifies the drive on which the magnetic tape is mounted. If unit is missing, drive 0 is as- 


sumed. 
FILES 

/dev/rmt? 
SEE ALSO 

tm (IV), ht (IV) 
BUGS 


Mim cannot distinquish between tape errors and end of files. 
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MV (1) MV (1) 
NAME 


mv — move or rename a file 


SYNOPSIS 
mv { —f ] namel name2 


DESCRIPTION 
Mv changes the name of a file from namel to name2. If named2 is a directory, name! is 
moved to that directory with its original file-name. Directories may only be moved 
within the same parent directory (just renamed). 


If name2 already exists, it is removed before name/ is renamed. If name2 has a mode 
which forbids writing, mv prints the mode and reads the standard input to obtain a 
line; if the line begins with y, the move takes place; if not, mv exits. The optional ar- 
gument -f allows the move to take place without verification. 


If name2 would lie on a different file system, so that a simple rename is impossible, mv 
copies the file and deletes the original. 


BUGS 
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NAME 
nice — run a command at low priority 


SYNOPSIS 
nice command [ arguments ] 


DESCRIPTION 
Nice executes command at low priority. 


SEE ALSO 
nohup(I), nice (II) 


BUGS 
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NM (I) NM(I) 
NAME 


nm — print name list 


SYNOPSIS 
nm [ —cjnru ] [ name ] 


DESCRIPTION 


Nm prints the symbol table from the output file of an assembler or loader run. Each symbol 
name is preceded by its value (blanks if undefined) and one of the letters U (undefined) A (ab- 
solute) T (text segment symbol), D (data segment symbol), B (bss segment symbol), or C 
(common symbol). Global symbols have their first character underlined. Normally, the output 
is sorted alphabetically and symbols consisting of a letter followed by one or more digits are not 
printed (that is, symbols which look like C internal symbols). 


If no file is given, the symbols in a.out are listed. 

Options are: 

—c List only C-style external symbols, that is those beginning with underscore ‘ _’. 

—j List symbols consisting of a letter followed by digits, which are normally suppressed. 
~—n Sort by value instead of by name. 

—r Sort in reverse order 

~u Print only undefined symbols. 


FILES 
a.out 


BUGS 
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NAME 
nohup — run a command immune to hangups 


SYNOPSIS 
nohup command [ arguments ] 


DESCRIPTION | 
Nohup executes command with hangups, quits and interrupts all ignored. 


SEE ALSO 
nice (I), signal (II) 
BUGS 
Beware of nohup on command lines with pipes. 
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NAME 
nroff — format text 
SYNOPSIS 
nroff [+] [—1] [—n«v)] [—mx)[—s][—h] [—q] [ —i] files 
DESCRIPTION 


Nroff formats text according to control lines embedded in the text files. Nroff will read the Stan- 


dard input if no file arguments are given. The non-file option arguments are interpreted as fol- 
lows: 


+n Output will commence at the first page whose page number is » or larger. 

—n Causes printing to stop after page nv. 

—nvn_ First generated (not necessarily printed) page is given number 7” - simulates "pnan". 
—mx Prefixes a standard macro file; simulates ".so /usr/lib/tmac. x’. 


—s Stop prior to each page to permit paper loading. Printing is restarted by typing a ‘new- 
line’ character. 


—h Spaces are replaced where possible with tabs to speed up output (or reduce the size of 
the output file). 


—q Prompt names for insertions are not printed and the bell character is sent instead; the 
insertion is not echoed. | 


—i Causes the standard input to be read after the files. 
Nroffis more completely described in [1]. A condensed Request Summary is included here. 


FILES 
/usr/lib/suftab suffix hyphenation tables 
/tmp/rtm? temporary 

SEE ALSO 
[1] NROFF User’s Manual. 

BUGS 


Mis-defined macros can cause the temporary file to overflow. 


Bell Telephone Laboratories, Incorporated 
PROGRAM APPLICATION INSTRUCTION 


NROFF (1) 
Request Initial If no 
Form Value 


I. Page Control 


aoe 


REQUEST REFERENCE AND INDEX 


Cause 
Argument Break Explanation 


Page Length. 
Begin Page. 
Page Number. 
Page Offset. 
NEed N lines. 


BReak. 

FIl] output lines. 

NoFill. 

ADjust mode on. 
NoAdjust. 

CEnter N input text lines. 


Line Spacing. 

SPace N lines 

LeaVe N lines 

SaVe N lines. 

Output Saved lines. 
No-Space mode on. 
Restore Spacing. 
EXtra-Half-line mode on. 


Line Length. 
INdent. 
Temporary Indent. 


DEfine or redefine a macro. 
Define or redefine String. 
ReMove macro name. 
DIvert output to macro "xx". 
W Hen; set a line trap. 
CHange trap line. 


Number Register. 
Number Character. 
Arabic numbers. 
Roman numbers. 
ROMAN numbers. 


-PseudoT Abs setting. 


Tab replacement Character. 


Leader replacement Character. 


UNderline input text lines. 


pl +N N=66 N=66 no 
.bp +N N=] - yes 
.pn +N N=1 ignored no 
.po +N N=0 N=prev no 
ne N - N=1 no 
Il. Text Filling, Adjusting, and Centering 
Or - - yes 
fi fill - yes 
nf fill - yes 
ad ¢ adj,norm adjust no 
na adjust - no 
ce N off N=] yes 
III. Line Spacing and Blank Lines 

is +N N=1 =prev no 
sp N - N=1 yes 
iv N - N=] no 
SVN - N=] no 
OS - - no 
ns space - no 
TS - - no 
xh off - no 
IV. Line Length and Indenting 

JL +N N=65 N=prev no 
in +N N=0 N=prev yes 
Ju +N - N=] yes 
V. Macros, Diversion, and Line Traps 
de xx - ignored no 
ds Xx - ignored no 
rm xx - - no 
di XX - end no 
wh -N xx. - - no 
ch xx y - - no 
ch-N-M_ - - no 
ch xx -M_ - - no 
ch-Ny - - no 
VI. Number Registers 

:nr ab +N -M - no 
nra+N -M : no 
nec \n \n no 
car arabic - no 
TO arabic - no 
RO arabic - no 
VII. Input and Output Conventions and Character Translations 
ta N/M... - none no 
lc c Space space no 
cc no 
Jul N - N=] no 
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cco c , ; no —__— Basic Control Character. 

c2c no Nobreak control character. 

ec C . \ no Escape Character. 

AiN - N=1 no Accept input lines LIterally. 

tr abcd... - | : no TRanslate on output. 

VIII. Hyphenation. | 

nh on - no No Hyphen. 

«hy on - no HY phenate. 

«he c none none no Hyphenation indicator Character. 

IX. Three Part Titles. 

tl ‘left’center'right’ - no TitLe. 

At N N=65 N=prev no Length of Title. 

X. Output Line Numbering. 

nm+NM SI off no Number Mode on or off, set parameters. 

npMSI - reset no Number Parameters set or reset. 


XI. Conditional Input Line Acceptance 


if !N anything - no IF true accept line of "anything". 
if c anything - no : 
if !c anything - no " 
jf N anything - no " 


XII. Environment Switching. 
ev N N=0 N=prev no EnVironment switched. 
XIII. Insertions from the Standard Input Stream 


Id prompt - bell no ReaD insert. 

.eX - - no EXit. 

XIV. Input File Switching 

so filename- . no Switch SOurce file (push down). 
.nx filename - no NeXt file. 

XV. Miscellaneous 

.tm mesg - - no Typewriter Message 

Ag - - no IGnore. 

fl - - no FLush output buffer. 


ab - - no ABort. 
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OD (1) oD (1) 
NAME 
od — octal dump 
SYNOPSIS 
od [ —abcdho | [ file] [[ + ] offset .][b] ] 
DESCRIPTION 


Od dumps /fi/e in one or more formats as selected by the first argument. If the first ar- 
gument is missing —o is default. The meanings of the format argument characters 
are: 


2 interprets words as PDP-11 instructions and dis-assembles the operation code. 
Unknown operation codes print as ???. 


interprets bytes in octal. 

interprets bytes in ascii. Unknown ascii characters are printed as \?. 
interprets words in decimal. 

interprets words in hex. 


Sa Oe 


® interprets words in octal. 
The file argument specifies which file is to be dumped. If no file argument is specified, 
the standard input is used. Thus od can be used as a filter. 


The offset argument specifies the offset in the file where dumping is to commence. 
This argument is normally interpreted as octal bytes. If ‘.” is appended, the offset is 
interpreted in decimal. If ‘b’ is appended, the offset is interpreted in blocks. (A block 
oe bytes.) If the file argument is omitted, the offset argument must be preceded by 


Dumping continues until end-of-file. 


SEE ALSO 
db (1) 


BUGS 
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-ONINTR (1) | ONINTR (1) 
NAME 


onintr — specify interrupt processing for a command file 


SYNOPSIS 
onintr [ label ] 


DESCRIPTION 
Onintr specifies that an interrupt processing routine begins at : ‘label’. The interrupt processing 
continues until a return, an exit, or the end of the command file is encountered. 
If an interrupt occurs on a command line n, control passes to the interrupt routine, and upon 
completion returns to the command line n+1, unless the completion was caused. by an exil 
command, whereupon sh terminates the command file. 


Onintr used without an argument specifies that upon interrupt the command file will terminate. 
During the execution of an interrupt process routine, interrupts are suppressed. 


SEE ALSO 
sh (1), return (I), exit (I), goto (1) 


FILES 
DIAGNOSTICS 
BUGS 
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NAME 
passwd — change login password 


SYNOPSIS 
passwd name password 


DESCRIPTION 
The password becomes associated with the given login name. This can only be done 
by corresponding user or by the super-user. An explicit null argument ("") for the 
password argument removes any password. 


FILES 
/etc/passwd 


SEE ALSO 
login (1), passwd (V), crypt (III) 


BUGS 
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NAME 
pfe — print floating exception 
SYNOPSIS 
pfe 
DESCRIPTION 


Pfe examines the floating point exception register and prints a diagnostic for the last 
floating point exception. 


SEE ALSO 
signal (II) 


BUGS 
Since the system does not save the exception register in a core image file, the message 
refers to the last error encountered by anyone. Floating exceptions are therefore vola- 
tile. 
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NAME 


pr — print file 


SYNOPSIS 


pr { —h header) [—n)] [+n] L—-wa) (-ln)] [-t] [ -—sc] [—m] name... 


DESCRIPTION 


FILES 


Pr produces a printed listing of one or more files. The output is separated into pages headed by 
a date, the name of the file or a specified header, and the page number. If there are no file ar- 
guments, pr prints its standard input, and is thus usable as a filter. 


Options apply to all following files but may be reset between files: 

—n produce #-column output 

+n begin printing with page n 

—h treat the next argument as a header to be used instead of the file name 


—wnfor purposes of multi-column output, take the width of the page to be » characters instead 
of the default 72 


—In take the length of the page to be » lines instead of the default 66 
—t do not print the 5-line header or the S-line trailer normally supplied for each page 


—sc separate columns by the single character c instead of by the appropriate amount of white 
Space. A missing c 1s taken to be a tab. 


—m_ print all files simultaneously, each in one column 
Interconsole messages via write (I) are forbidden during a pr. 


/dev/tty? to suspend messages. 


SEE ALSO 


cat (1), cp (1) 


DIAGNOSTICS 


BUGS 


none; files not found are ignored 
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NAME 
prof — display profile data 
SYNOPSIS | 
prof [—a][-—1] [ file] 
DESCRIPTION 
Prof interprets the file mon.out produced by the ‘monitor subroutine. Under default 
modes, the symbol table in the named object file (a.owt default) is read and correlated 
with the mon.out profile file. For each external symbol, the percentage of time spent 
executing between that symbol and the next is printed (in decreasing order), together 
with the number of times that routine was called and the number of milliseconds per 
call. , 
If the —a option is used, all symbols are reported rather than just external symbols. If 
the —1 option is used, the pouneHs is listed by symbol value rates than decreasing per- 
centage. 
In order for the number of calls to a routine to be tallied, the —p option of cc must 
have been given when the file containing the routine was ‘compiled. This option also 
arranges for the mon.out file to be produced automatically. 
FILES | | 
mon.out for profile 
a.out for namelist 
SEE ALSO | 
monitor (III), profil (II), cc (D) 
BUGS 


Beware of quantization errors. 
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PS (1) PS (1) 
NAME 
ps — process status 
SYNOPSIS 
ps [ -aklx ] [ file ] 
DESCRIPTION 


Ps prints certain data about active processes. If a file is specified, it must contain the system 
namelist for the running process if it is not in /unix. There are several options: 


a asks for information about all processes with teletypes. Ordinarily, only one’s own 
processes are displayed. 


reports on all processes regardless of typewriter. 
uses the special file /dev/rpO in place of /dev/mem. 
| provides a long listing which contains the following meaningful columns: 


Heading Description 
TTY the last character of the control typewriter of the process. 
F a number encoding the flags associated with a process. It may be any 


combination of the following: 


00 swapped-out process 
01 swapped-in process 
02 the scheduler 

04 process locked tn core 
30 tracing 


S a letter encoding the state of the process: 
S -_ sleeping 
- waiting 


W 

R - running 
I - idling (unused) 
Z 


- zombie - process exited, parent not yet notified. 


T - traced 
UID the real user-id of the owner of the process. 
PID the unique process number; this is useful with 
kill. | 
PRI the priority of the process, high numbers 
mean low priority 
ADDR the location of the process, in 64-byte 


granularity for swapped-in processes; 
in 512-byte granularity for swapped-out processes. 


SIZE the size in blocks of the core image of the process. 
WCHAN the core address in the system of the event 


for which the process is waiting. If blank, 
the process is running. 


COMMAND the file name of the process. 


Ps attempts to learn the file name and arguments given when the process was createc, by exam- 
ing core memory and/or the swap area. 
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PS (T) 

FILES | 
/unix system namelist 
/dev/mem core memory 
/dev/rp0 swap device 
/dev/rkO optional mem file 

SEE ALSO 
kill (I) 


BUGS 


i ap Dk 
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PWD (1) PWD (1) 


NAME 
pwd — working directory name 


SYNOPSIS 
pwd 


DESCRIPTION _ | 
Pwd prints the pathname of the working (current) directory. 


SEE ALSO 
chdir (I) 


BUGS 
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READ (1) READ (1) 


NAME 
read, open, onend — sequential file read 


SYNOPSIS 
onend [ label | 
open [ fname ] 
read 


DESCRIPTION ie. | 
Within a command file, read accesses data, one line at a time from another file. The read is 
done sequentially from the beginning of the file. 

Open is needed to identify the file to be read. Only one file may be open at any time. Without 
an argument the standard input ts used. 
Onend provides a branch to /abe! when the EOF condition is reached on fname. If label is not 


supplied, a diagnostic is written to the error output,and a null string is sent to the standard out- 
put. 


FILES 


SEE ALSO 
sh (1), goto (I), read (II) 


DIAGNOSTICS 


BUGS 
Standard Shell syntax is violated to allow pipe and redirected input to take precedence over an 
open file, which in turn takes precedence over standard Shell input. 
Don’t try to read a directory file. 
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NAME 
return — terminate profile or interrupt processing routine 


SYNOPSIS 
return [ rtncode |] 


DESCRIPTION 
Return terminates processing of a profile file or an interrupt processing routine within a com- 
mand file. In any other case, sh treats return as an exit. 


The return code is set to the optional argument ‘rtncode’, otherwise to 0. 


SEE ALSO 
sh(I), exit(I) 
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NAME . 
rew — rewind tape 


SYNOPSIS . 
rew [ [ m Jdigit ] 


DESCRIPTION 
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Rew rewinds DECtape or magtape drives. The digit is the logical tape number, and 
should range from 0 to 7. if the digit is preceded he m, rew applies to magtape rather 


than DECtape. A missing digit indicates drive'0. 


FILES 
/dev/tap? 
/dev/mt? 


BUGS 


Magnetic tape units 4-7 map into physical drives 0-3. 


Bell Telephone Laboratories, Incorporated -|- PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section | 


Issue |, January 1976 
AT&TCo SPCS 


RM (1) RM (1) 


NAME 


rm — remove (unlink) files 


SYNOPSIS 


rm [ -f] [ —r] name... 


DESCRIPTION 


FILES 


Rm removes the entries for one or more files from a directory. If an entry was the 
last link to the file, the file is destroyed. Removal of a file requires write permission in 
its directory, but neither read nor write permission on the file itself. 


If a file has no write permission, rm prints the file name and its mode, then reads a 
line from the standard input. If the line begins with y, the file is removed, otherwise 
it is not. The file is removed without the question being asked if option —f was given 
or if the standard input is not a typewriter. 


If a designated file is a directory, an error comment is printed unless the optional argu- 
ment —r has been used. In that case, rm recursively deletes the entire contents of the 
specified directory. To remove directories per se see rmdir(]). 


/etc/glob to implement the —r flag 


SEE ALSO 


BUGS 


rmdir (I) 


When rm removes the contents of a directory under the —r flag, full pathnames are 
not printed in diagnostics. 
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RMDIR (1) RMDIR (I) 


NAME 
rmdir — remove directory 


SYNOPSIS 
rmdir dir ... 


DESCRIPTION . | 
Rmdir removes ae directories.. The directory must be empty: (except for the 
standard entries ‘.’ and ‘..’, which rmdir itself removes). 


BUGS 
Needs a —r flag. | 
Write permission in the dirsdiory: S parent Sieald be eeuuiredl: ee is not. 
Mildly unpleasant consequences can follow Temoual: of: yout own or someone else’s 
current directory. . 
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NAME 
sh — shell (command interpreter) 


SYNOPSIS 
sh [—v] [ —i] [ —te] [ name [ arg] ... [ arg9 ] ] ] 


DESCRIPTION 
Sh is the standard command interpreter. It reads and arranges the execution of the command 
lines typed by the user. Unless an alternative is specified in the entry of a user in /etc/passwd, a 
copy of sh is provided at login time. Sh may itself be called as a command to interpret com- 
mand lines and/or command files. Before discussing the arguments to the Shell used as a com- 
mand, the structure of command lines themselves will be given. 


Commands. Each command is a sequence of arguments separated by blanks or tabs. The first 
argument specifies the name of a command to be executed. Except for certain types of special 
arguments discussed below, the arguments other than the command name are passed without 
interpretation to the invoked command. 


If the first argument is the name of an executable file, it is invoked; otherwise the string ‘/bin/’ 
is prefixed to the argument. (In this way most often-used commands, which reside in ‘/bin’, 
are found.) If no such command is found, the string ‘/usr’ is further prefixed (to give 
‘/usr/bin/command’) and another attempt is made to execute the resulting file name. (Certain 
lesser-used commands live in ‘/usr/bin’.) If ‘/usr/bin/command’ exists with executable mode, 
but does not have the form of an executable program, it is used by s/ as a file of commands, 
that is to say, it is executed as if it were typed from the console. 


An attempt to execute either a file without execute permission or a directory results in a diag- 
nostic mesSage, as does the inablility to find the file. 


y 


Pipe-lines. Commands separated by ‘| or ‘** constitute a sequence of processes called a pipe- 
line. The standard output of each command but the last is taken as the standard input of the 
next command. Each command is run as a Separate process, connected to its neighbors by 
pipes (see pipe(II)). | 


Two or more commands may appear on the same line in other ways. When they are separated 
by ‘;’, the commands are executed in order of appearance on the line. However, if a command 
is followed by ‘&’, s4 does not wait for the completion of that process, but reports the process- 
id of the executing process, and continues with the next command. 


Commands on a line may be grouped by using parentheses. To illustrate: 
(pwd:date) | Ipr 
sends the name of the current directory and the date to the line printer. 


Redirection of 1/O. Three files are opened by sh. A standard input file (file descriptor 0) from 
which input lines are read; a standard output file (file descriptor 1) on which printed output can 
be written; and a standard error output file (file descriptor 2) on which diagnostics can be writ- 
ten. These files normally point to the user’s typewriter but can he redirected to other devices 
or files. : . 


There are five redirection symbols that cause the immediately following string to be interpreted 
as a special argument to the Shell itself. Such an argument may appear anywhere among the ar- 
guments of a command, or before or after a parenthesized command list, and is associated with 
that command or command list. 


<name _ causes the file ‘name’ to be used as the standard input of the associated com- 
mand. | | 
>name — causes file ‘name’ to be used as the standard output for the associated command. 


‘Name’ is created if it did not exist, and is truncated at the outset. When ‘%° is 
used as ‘name’, the output is directed to the standard error output file. 
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>>name causes file ‘name’ to be used as the standard output for the associated command. 
If ‘name’ did not exist, it is created; if it did exist, the command output is ap-_ 
pended to the file. 


As an example, either of the command lines 


Is >junk, cat tail > >junk 
(Is; cat tail ) >junk 


creates, on file ‘junk’, a listing of the working BE CION followed | immediately by 
the contents of file ‘tail’. 


Either of the constructs ‘>name’ or ‘>>name’ associated with any but the last 
command of a pipe-line is ineffectual, as is ‘<name’ in any but the first. 


%name causes ‘name’ to be used as the error output file for the associated command. 
‘Name’ is created if it did not exist and is truncated at the outset. 


%%name causes ‘name’ to be used as the error output for ‘the associated command. If 
‘name’ did not exist, it is created; if it existed, the error output is appended to 
the file. 


Generation of argument lists. If any argument contains any of the characters ‘?’, ‘*’ or ‘[, 
is treated specially as follows. The directory is searched for files which match the given ee 
ment according to the following rules: 


1. The character *** in an. argument arenes any string” ai characters in a file ‘name’ (in- 
cluding the null alii _ 


2. The character °?’ matches any single hiapacter in a file name. 


3. Square brackets ‘[...])’ specify a class of characters which matches any single file-name 
character in the class. Within the brackets, each ordinary character is taken to be a 
member of the class. A pair of characters separated by ‘—* places in the class each char- 
acter lexically greater than or equai to the first and less than or equal to the second 
member of the pair. 


4. Other characters match only the Same character in ihe file name. 


e439 


For example, ‘*’ matches ail file names; matches all one-character file names, ‘[ab]*.s° 
matches all file names beginning with ‘a’ or ‘b’ and ending with °.s’; ‘?[zi—m]’ matches all 
two-character file names ending with ‘z’ or the letters ‘i’ through ‘m’.. i 


If the argument with ‘*’ or ‘?’ also contains a ‘/’, a slightly different procedure is used: instead 
of the current directory, the directory used is the one ubtained by taking the argument up to 
the last ‘/’ before a **’ or ‘?*. The matching process matches the remainder of the argument 
after this ‘/’ against the files in the derived See For eta ‘/ust/dmr/a* .S’ matches all 
files in directory ‘/usr/dmr’ which begin with ‘a’ and end with ‘ 


By this procedure a list of names is obtained in match the argument. This list is sorted into 
alphabetical order, and the resulting sequence of arguments replaces the single argument con- 
taining the ‘*’, ‘[’, or ‘?°. The same process is carried out for each argument (the resulting lists 
are not merged) and finally the command is called with the resulting list of arguments. 


Quoting. The character ‘\’ causes the immediately following character to lose any special 
meaning it may have to the Shell, in this way ‘<°, ‘>’, and other characters meaningful to the 
Shell may be passed as part of arguments. A special case of this feature allows the continuation 
of commands onto more than one line: a new-line preceded by ‘\’ is translated into a blank. 


Quoting may be accomplished by double (") or single (°) quotes in the following way: 
Is | pr —h “My directory" - | | 


Causes a directory listing to be produced by /s. and passed on to pr to be printed with the head- 
ing ‘My directory’. Quotes permit the inclusion of blanks in the heading, which is a single ar- 
gument to pr. Characters enclosed in double quotes have no special significance to sh, which 
passes them along as an argument with no-interpretation. Within single quotes, sh expands ‘\’ 
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and ‘$’, and takes all other characters literally. 


Command Files. Since sh treats its first argument as a command, that argument may itself be 
sh; thus giving the Shell recursive power. A file of commands to the Shell may be prepared pri- 
or to execution of sh. Either of the commands 

sh < file 

sh file 


will cause the execution of the file of commands. 


Sh becomes a simple but powerful programming language by the inclusion of the following 
commands that have meaning within a command file: 


goto supplies the branch facility. (see goto (I)) 

exit terminates a shell. (see exir (1)) 

: label locates the destination of a branch. The line itself is meaningless to sh and is 
ignored. 

return transfers control within a command file. (see return (1)) 

shift - manipulates the arguments of a command file. (see s/ufi (1)) 

if a conditional statement. (see // (1)) 

onintr identifies the routine to be used for interrupt processing. (see onmuir (1)) 

read along with onend, and open, provides a facility for accessing information 


sequentially from a file outside the command file. (see read (1)) 
echo writes data to the standard output. (see echo (1)) 


= x [value] makes an assignment of va/ve to a single letter variable within a command file. 
If value is not specified, the variable takes on the value of the entire next line 
of the standard input. These variables once assigned, may be referenced 
throughout the command file as ‘$a’,‘$b’,...°$z’ 


_ Certain other variables may be referenced within a command file: 
$0 the name of the command file. When no name exists, $0 is null. 


$$ the process-id of the executing shell, expressed in five decimal digits (with leading 
zeroes). 


$. the pathname of the directory from which the command file was executed. 
$T the pathname of the controlling typewriter. 


$E an octal representation of the return code of the most recently completed process in 
the file. It is useful with the //statement. 


$R same value as $E in decimal representation. 
Argument passing. When s/: 1s invoked as a command, it has additional string processing capa- 
bilities. Recall that the form in which the Shell is invoked ts 

sh [ name [ arg] ... [arg9 ] ] ] 
Namie is a file which is read and interpreted. If not given, this subinstance of the Shell contin- 
ues to read the standard input file. 


In command lines in the file (not in command input), character sequences of the form ‘$n’, 
where #/ is a digit, are replaced by the wth argument to the invocation of the Shell (argn). ‘$0° 
is replaced by name. Up to nine arguments can be referenced at any one time. 


Optional arguments which may be supplied to s/. 


—t Used alone, it causes s/ to read a single line from the standard input, execute it as a 
command, and then exit. It is useful for interactive programs which allow users to exe- 
cute system commands. For example, see‘'’ in bc (I) and ed (1). 
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—c Used with one following argument it causes the next argument to be taken as a com- 
mand line and executed. No new-line need be present, but new-line characters are treat- 
ed appropriately. It is useful as an alternative to —t where the caller has already read 
some of the characters of the command to be executed. 


— A new shell process is invoked which reads from the standard input. No prompts are is- 
sued in this environment. 


—v When the verbose option is selected, sh will echo all command lines as they are execut- 
ed. The feature is useful in debugging command files. 


—1 Interrupts are ignored by sh. Ordinarily interrupts terminate a command file process. 


If a user supplies a command file named profile.sh in his login directory, sh executes that com- 
mand file at its first invocation. This is useful for setting up a specific environment in which to 
work. 


End of file. An end-of-file in the Shell's input causes it to exit. A side effect of this fact means 
that the way to log out from UNIX is to type an EOT. 


Special commands. The following commands are treated specially by the Shell. 
chdir is done without spawning a new process by executing sys chdir (II). 


login is done by executing /bin/login without creating a new process. 
wait is done without spawning a new process by executing sys wait (ID). 
exit is done without spawning a new process by executing sys exit (II). 


return is done without spawning a new process, either by calling sys exit or by returning 
to standard Shell input. 


shift is done by manipulating the arguments to the command file. 

= is done by storing the assigned value in a dynamic buffer that increases in size 
with each new assignment. 

read 

open 

ouend — are all done without spawning a new process so the Shell can keep its place in the 
file being read. 


onintr is done without spawning a new process for the interrupt processing routine to 
handle trap resets. 


Command file errors; interrupts. Any Shell-detected error, or an interrupt signal, during the 
execution of a command file causes the Shell to cease execution of that file. 


Processes that are created with ‘&’* ignore interrupts. In addition, if such a process has not 
redirected its inpul with a ‘<’, its input is automatically redirected to the zero length file 
/dev/null. 


Termination Reporting. If a command (not followed by ‘&’) terminates abnormally, a mes- 


_ Sage iS printed. (All terminations other than exit and interrupt are considered abnormal.) Ter- 


mination reports for commands followed by ‘&’ are given upon receipt of the first command 
subsequent to the termination of the command, or when a wait is executed. The following is a 
list of the abnormal termination messages: 
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Bus error 
Trace/BPT trap 
Illegal instruction 
IOT trap 

EMT trap | 

Bad system call 
Quit 

Floating exception 
Memory violation — 
Killed 

Broken Pipe 
Alarm timeout 


If a core image is produced, ‘— Core dumped’ is appended to the appropriate message. 


FILES 
/etc/glob, which interprets ‘*’, ‘?’, and ‘[’. 
/dev/null as a source of end-of-file. 
/dev/tty?, the control typewriter. 7 
$./profile.sh, to set-an individual user’s environment. 


SEE ALSO 
‘The UNIX Time-Sharing System’, CACM, July, 1974, which gives the theory of operation of 
the Shell. 
chdir (I), login (I), wait (I), shift (1), goto (1), read (I), return (1), exit (1), onintr (I), glob 
(VIII), echo (I), pipe (II). 


DIAGNOSTICS 
‘Too many tokens’,;Command table overflow’, and ‘Too many characters’, indicate buffer 
overflow. The command line is terminated. 
‘*$’ nesting error’; if more than nine levels of arguments occurs. The command line is ter- 
minated. 


BUGS 
Too many variable assignments in a command file may result in buffer overflow. 
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NAME | 
shift — adjust Shell arguments 
SYNOPSIS 
shift [n ] 
DESCRIPTION 


Shift is used in command files to shift the argument list left by 1, so that old $2 can now be re- 
ferred to by $/ and so forth. Shift is uate to iterate over several Arguments { to a command file. 
For example, the command file 

: loop 7 

if $1x = x exit 

pr —3 $1 

shift 

goto loop 


prints each of its arguments in 3-column format. 


The optional argument, n leaves the first n-1 arguments untouched, ad replaces arg n with arg 
n+1, arg n+1 with arg n+2, .... through the remainder of the argument list. 


Shift is executed within the Shell. 


SEE ALSO 
sh (I) 


BUGS 
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NAME 
size — size of an object file 


SYNOPSIS 
size [ object ... ] 


DESCRIPTION 
Size prints the (decimal). number of bytes required by the text, data, and bss portions, 
and their sum in octal and decimal, of each object-file argument. If no file is specified, 
a.out is used. | 7 


BUGS 
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NAME 
sleep — suspend execution for an interval 
SYNOPSIS | 
sleep time 
DESCRIPTION 


Sleep suspends execution for time seconds. tis ‘used to’ execute a command iin a certain 
amount of time as in: a er | ee oe ee eee 
(sleep 105; command) & 


or to execute a command every so often as in this shell command file: 


: loop 
command 
sleep 37 
goto loop 
SEE ALSO 
sleep (II) 
BUGS 


Time must be less than 65536 seconds. 
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NAME 


sort — sort or merge files 


SYNOPSIS 


sort [| —mubdfinrtx ] [ +pos [ —pos]]... [ —o name ] [ name ] ... 


DESCRIPTION 


FILES 


BUGS 


Sort sorts lines of all the named files together and writes the result on the standard 
output. The name *—’ means the standard input. The standard input is also used if 
no input file names are given. Thus sort may be used as a filter. | 


The default sort key is an entire line. Default ordering is lexicographic by bytes in 
machine collating sequence. The ordering is affected by the following flags one or 
more of which may appear. 


b Leading blanks (spaces and tabs) are not included in keys. 

d ‘Dictionary’ order: only letters, digits and blanks are significant in comparisons. 
f Fold lower case letters onto upper case. 

i Ignore all nonprinting nonblank characters in nonnumeric comparisons. 


n An initial numeric string, consisting of optional minus sign, digits and optionally 
included decimal point, is sorted by arithmetic value. 


r Reverse the sense of comparisons. 
tx Tab character starting fields is x. 


Selected parts of the line, specified by + pos and — pos, may be used as sort keys. Pos 
has the form #7.» optionally: followed by one or more of the flags bdfinr, where mm 
specifies a number of fields to skip, » a number of characters to skip further into the 
next field, and the flags specify a special ordering rule for the key. A missing .n is tak- 
en to be 0. +psos denotes the beginning of the key; — pos denotes the first position 
after the key (end of line by default). Later keys are compared only when all earlier 
keys compare equal. 


When no tab character has been specified, a field consists of nonblanks and any 
preceding blanks. Under the —b flag, leading blanks are excluded from a field. When 
a tab character has been specified, fields are strings separated by tab characters. 


Lines that otherwise compare equal are ordered with all bytes significant. 
These flag arguments are also understood: 
—m Merge only, the input files are already sozted. 


—o The next argument is the name of an output file to use instead of the standard 
Output. This file may be the same as one of the inputs, except under the merge 
flag —m. 


—u Suppress all but one in each set of contiguous equal lines. Ignored bytes and 
bytes outside keys do not participate in this comparison. | 


Examples. Print a list of all the distinct nroff (1) commands in a given document: 
grep "“\." document | sort —u +0 —0.3 

Print the password file passwd (V) sorted by user id: 
sort —t: +2n /etc/passwd 


/usr/tmp/stm??? 
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NAME 
split — split a file into pieces 
SYNOPSIS 
split [—7 ] [file iaamell ] 
DESCRIPTION 


Split reads file and writes it in n-line pieces (default 1000), as many as necessary, onto 
a set of output files. The name of the first output file is name with aa appended, and 
so on lexicographically. If no output name is given, x is default. 


If no input file is given, or if — is given in its stead, then the standard input file is 
used. 


BUGS 
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NAME 
strip — remove symbols and relocation bits 
SYNOPSIS 
strip name ... 
DESCRIPTION 7 


Strip removes the symbol table and relocation bits ordinarily attached to the output of 
the assembler and loader. This is useful to save space after a program has been de- 
bugged. 


The effect of strip is the the same as use of the —s option of /d. 


FILES 
/tmp/stm? temporary file 


SEE ALSO 
Id (1), as (I) 


BUGS 
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NAME 
stty — set typewriter options 
SYNOPSIS 
stty [ option ... ] 
DESCRIPTION 
Stty sets certain I/O options on the current output typewriter. With no argument, it reports the 
current settings of the options: ne Spun Renae are, eclecie fe the following set: 
even allow even parity) ny 
—even disallow even parity 
odd allow odd parity) 2 i 
—odd disallow odd parity 
raw raw mode input (no erase, kill, interrupt, quit, EOT, parity. bit passed back) 
—raw negate raw mode 
—nil allow carriage return for new-line, and output CR-LF for carnage return or new-line 
nl accept only new-line to end lines , . 
echo echo back every character typed 
—echo do not echo characters 
Icase map upper case to lower case 
—tlcase do not map case 
—tabs replace tabs by spaces when printing 
tabs preserve tabs 
cr0 erl cr2 cr3 
select style of delay for carriage return (see srty (II)) 
nl0 all nl2 ni3 
select style of delay for linefeed (see sity (II)) 
tab0 tabl tab2 tab3 
select style of delay for tab (see srty (II)) 
ff0 ff1 | 
select style of delay for form feed (see stty (II)) 
tty33 set all modes suitable for Teletype model 33 
tty37 set all modes suitable for Teletype model 37 
vt05 set all modes suitable for DEC VTOS terminal 
tn300 set all modes suitable for GE Terminet 300 
ti700 set all modes suitable for Texas Instruments 700 terminal 
tek set all modes suitable for Tektronix 4014 terminal 
50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 
Set typewriter baud rate to the number given, if possible. (These are the speeds 
supported by the DH-11 interface). 
The various delay algorithms are tuned to various kinds of terminals. In general the 
specifications ending in ‘0° mean no delay for the corresponding character. 
SEE ALSO 


stty (II) 
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NAME 

sum — sum file 
SYNOPSIS 

sum name ... 
DESCRIPTION 


Sum suras the contents of the bytes (mod 2°16) of one or more files and prints the answer in 
decimal. A separate sum is printed for each file specified, along with the number of whole or 
partial 512-byte blocks read. 


In practice, suis often used to verify that all of a special file can be read without error. 


BUGS 
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TIME (1) TIME (1) 
NAME 


time — time a command 


SYNOPSIS | 
time command 


DESCRIPTION 
The given command is executed; after it is complete, time prints the elapsed time dur- 
ing the command, the time spent in the ‘system, and the time spent in execution of 
the command. 


The execution time can depend on what kind of memory the Program happens to land 
in; the user time in MOS is:often half what it is in core.. 


The times are printed on the diagnostic output stream. 


BUGS 
Elapsed time is accurate to the second, while the CPU times are measured to the 60th 
second. Thus the sum of the CPU times can be up to a second larger than the elapsed 
time. 
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tp — manipulate DECtape and magtape 


SYNOPSIS 


tp [ key ] [ name ... ] 


DESCRIPTION 


Tp saves and restores files on DECtape or magtape. Its actions are controlled by the 
key argument. The key is a String of characters containing at most one function letter 
and possibly one or more function modifiers. Other arguments to the command are 
file or directory names specifying which files are to be dumped, restored, or listed. In 
all cases, appearance of a directory name refers to the files and (recursively) subdirec- 
tories of that directory. 


The function portion of the key is specified by one of the following letters: 


r 


The named files are written on the tape. If files with the same names already 
exist, they are replaced. ‘Same’ is determined by string comparison, so 
‘/abc’ can never be the same as ‘/usr/dmr/abc’ even if ‘/usr/dmr’ is the 
current directory. If no file argument is given, ‘.’ is the default. 


Update the tape. u is like r, but a file is replaced only if its modification date 
is later than the date stored on the tape; that is to say, if it has changed since 
it was dumped. uw is the default command if none is given. 


Delete the named files from the tape. At least one name argument must be 
given. This function is not permitted on magtapes. 


Extract the named files from the tape to the file system. The owner and 
mode are restored. If no file argument is given, the entire contents of the 
tape are extracted. 


List the names of the specified files. If no file argument is given, the entire 
contents of the tape is listed. 


The following characters may be used in addition to the letter which selects the func- 
tion desired. 


m 


0... 


Specifies magtape as opposed to DECtape. 


.,7 This modifier selects the drive on which the tape is mounted. For DEC- 


tape, ‘x’ is default; for magtape ‘0’ is the default. 


Normally ¢p does its work silently. The v (verbose) option causes it to type 
the name of each file it treats preceded by the function letter. With the t 
function, v gives more information about the tape entries than just the 
name. 


A fresh dump is to be created; the tape directory is zeroed before begin- 
ning. Usable only with r and u. This option is assumed with magtape 
Since it is impossible to selectively overwrite magtape. 


causes new entries on tape to be ‘fake’ in that no data is present for these 
entries. Such fake entries cannot be extracted. Usable only with r and u. 


Errors reading and writing the tape are noted, but no action is taken. Nor- 
mally, errors cause a return to the command level. 


causes tp to pause before treating each file, type the indicative letter and the 
file name (as with v) and await the user’s response. Response y means 
‘yes’, so the file is treated. Null response means ‘no’, and the file does not 
take part in whatever is being done. Response x means ‘exit’; the /p com- 
mand terminates immediately. In the x function, files previously asked 
about have been extracted already. With r, u, and d no changc has been 
made to the tape. 
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FILES 
/dev/tap? 
/dev/mt? 
DIAGNOSTICS 


Several; the non-obvious one is ‘Phase error’, which means the file changed after it 
was selected for dumping but before it was dumped. 


BUGS | | 
A single file with several links to it is treated like several files. 
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tr — transliterate 


SYNOPSIS 


tr [ —cds ] [ string] [ string2 ] ] 


DESCRIPTION 


7r copies the standard input to the standard output with substitution or deletion of selected 
characters. Input characters found in string/ are mapped into the corresponding characters of 
string2. 

Any combination of the options —cds may be used. 


—c complements the set of characters in string/ with respect to the universe of characters 
whose ascii codes are 001 through 377 octal. 


—d deletes all input characters in string/. 
—s squeezes all strings of repeated output characters that are in s/ring2 to single characters. 


The following abbreviation conventions may be used to introduce ranges of characters or re- 
peated characters into the strings: 


[a— 6 stands for the string of characters whose ascii codes run from character a to character b. 


(an, where 7 is an integer or empty, stands for n-fold repetition of character a. 1 is taken to be 
octal or decimal according as its first digit is or is not zero. A zero or missing 7 is taken to be 
huge, this facility is useful for padding string2. 

The escape character ‘\’ may be used as in sh to remove special meaning from any character in 
a string. In addition, ‘\’ followed by 1, 2 or 3 octal digits stands for the character whose ascii 
code is given by those digits. 


The following example creates a list of all the words in ‘filel’ one per line in ‘file2’, where a 
word is taken to be a maximal string of alphabetics. The strings are quoted to protect the spe- 
cial characters from interpretation by the Shell; 012 is the ascii code for newline. 


tr —cs "[A—Z][a—z]" "[\012*]" <filel >file2 


SEE ALSO 


BLGS 


sh (I), ed (I), ascii (V) 


Won’t handle ascii NUL in string/ or string2; always deletes NUL from input. 
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tty — get typewriter name 


SYNOPSIS 
tty 


DESCRIPTION 
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Tty gives the name of the user’s typewriter in the form ‘ttyz’ for na digit or letter. 
The actual path name is then ‘/dev/ttyn’. 


DIAGNOSTICS 


‘not a tty’ if the standard input file is not a typewriter. — 


BUGS 
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NAME 


typo — find possible typos 


SYNOPSIS 


typo [ —-1] [ —n] file... 


DESCRIPTION 


FILES 


BUGS 


Typo hunts through a document for unusual words, typographic errors, and hapax fegomena and 
prints them on the standard output. 


The words used in the document are printed out in decreasing order of peculiarity along with an 
index of peculiarity. An index of 10 or more is considered peculiar. Printing of certain very 


~ common English words is Suppressed. 


The statistics for judging words are taken from the document itself, with some help from known 
Statistics of English. The —n option: suppresses the help from English and should be used if 
the document is written in, for example, Urdu. 


The —1 option causes the final output to appear in a single column instead of three columns. 
The normal header and pagination is also suppressed. 


Nroff (1) control lines are ignored. Upper case is mapped into lower case. Quote marks, verti- 
cal bars, hyphens, and ampersands within words are equivalent to spaces. Words hyphenated 
across lines are put back together. 


/tmp/ttmp?? 
/usr/lib/salt 
/usr/lib/w2006 


Because of the mapping into lower case and the stripping of special characters, words may be 
hard to locate in the original text. 
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NAME 
uniq — report repeated lines in a file 


SYNOPSIS 
unig [ —ude [ +n] [—n] ] [input [ output } ] 


DESCRIPTION | | 
Uniq reads the input file comparing adjacent lines. In the normal case, the second and 
succeeding copies of repeated lines are removed; the remainder is written on the out- 
put file. Note that repeated lines must be adjacent in order to be found; ‘see sort(I). 
If the —u flag is used, just the lines that are not repeated in the original file are out- 
put. The —d option specifies that one copy of just the repeated lines is to be written. 
The normal mode output is the union of the —u and —d mode outputs. 


The —c option supersedes —u and —d and generates. an output report in default style 
but with each line preceded by a count of. the number of times it occurred. 


The n arguments specify skipping an initial portion of each line in the comparison: 


—n The first » fields together with any blanks before each are ignored. A field is 
defined as a string of non-space, non-tab_ enaeiels eeparatce ee tabs and 
spaces from its neighbors. 


+n The first » characters are ignored. Fields : are isped befére characters. 


SEE ALSO 
sort (1), comm (I) 


BUGS 
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NAME 
wait — await completion of process 


SYNOPSIS 
wait [ cpid ] 


DESCRIPTION | 
Wait waits until all processes started asynchronously (with ‘&’) have terminated. If a child 
process-id (cpid) is specified as an argument, then the wait is only for termination of that asyn- 
chronous process. | | 


SEE ALSO 
sh (1) 


BUGS 
If cpid is not an asynchronous process, then wait waits for the termination of all asynchronous 
processes. It should indicate that cpid is invalid. 
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NAME 
wc — word count 


SYNOPSIS | 
we [ name ... ] 


DESCRIPTION -_ 
Wc counts lines and words in the named files, or in the standard input if no name ap- 
pears. A word is a maximal string of printing characters delimited by spaces, tabs or 
newlines. All other characters are simply ignored. 


BUGS 
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NAME 
who — who is on the system 
SYNOPSIS 
who [ who-file ] 
DESCRIPTION 
Who, without an argument, lists the name, typewriter channel, and login time for each current 
UNIX user. 


Without an argument, who examines the /tmp/utmp file to obtain its information. If a file is 
given, that file is examined. Typically the given file will be /tmp/wtmp, which contains a record 
of all the logins since it was created. Then who will list logins, logouts, and crashes since the 
creation of the wtmp file. 


Each login is listed with user name, typewriter name (with ‘/dev/’ suppressed), and date and 
time. When an argument is given, logouts produce a similar line without a user name. Re- 
boots produce a line with ‘x’ in the place of the device name, and a fossil time indicative of 
when the system went down. 


FILES 
/tmp/utmp 


SEE ALSO 
login(1), init(VID 


BUGS 
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NAME 


write — write to another user 


SYNOPSIS 


write user [ ttyno ] 


DESCRIPTION 


Write copies lines from your typewriter to that of another user. When first called, it sends the 
message : 


message from yourname... 


The recipient of the message should rile: eae at this | point. Communication continues until 
an end of file is read from the typewriter or an interrupt is sent. ‘At that point write writes 
‘EOT’ on the other terminal and exits. “ 3 | 3 


If you want to write to a user who is logged in more than once, the ttyno argument may be used 
to indicate the last character of the appropriate. typewriter name. 


Permission to write may be denied or granted by use of the mesg command. At the outset writ- 
ing is allowed. Certain commands, in particular nroff and pr, disallow messages in order to 
prevent messy ee 


If the character ‘!’ is found at the beginning of a line, write calls the shell to execute the rest of 
the line as a ee 


The following protocol is suggested for using write: when you first write to another user, wait 
for him to write back before starting to send. Each party should end each message with a dis- 
tinctive signal ( (0) for ‘over’ is conventional) that the other may reply. (00) (for ‘over and 
out’) is suggested when conversation is about to be terminated. 


FILES 
/tmp/utmp to find user 
/bin/sh to execute ‘!’ 

SEE ALSO 


BUGS 


mesg (I), who (I), mail (I) 


Bell Telephone Laboratories, Incorporated -l- PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section | 


Issue 1, January 1976 
AT&TCo SPCS 


YACC (T) YACC (1) 


NAME 


yacc — yet another compiler-compiler 


SYNOPSIS 


yace [ —vo ] [ grammar ] 


DESCRIPTION 


Yacc converts a context-free grammar into a set of tables for a simple automaton which exe- 
cutes an LR(1) parsing algorithm. The grammar may be ambiguous; specified precedence rules 
are used to break ambiguities. 


The output is y.fab.c, which must be compiled by the C compiler and loaded with any other 
routines required (perhaps a lexical analyzer) and the Yacc library: 


cc y.tab.c other.o —ly 


If the —v flag is given, the file y.ouwtput is prepared, which contains a description of the parsing 
tables and a report on conflicts generated by ambiguities in the grammar. 


The —o flag calls an optimizer for the tables; the optimized tables, with parser included, appear 
on file y.tab.c 


SEE ALSO 


‘‘LR Parsing’, by A. V. Aho and S. C. Johnson, Computing Surveys, June, 1974. ‘‘The 
YACC Compiler-compiler’’, UNIX handbook. 


ALTHOR 


FILES 


S. C. Johnson 


y.output 

y.tab.c 

yacc.tmp when optimizer is called 
/lib/liby.a runtime library for compiler 
/usr/source/yacc/opar.c parser for optimized tables 
/usr/yacc/yopti optimizer postpass 


DIAGNOSTICS 


BUGS 


The number of reduce-reduce and shift-reduce conflicts is reported on the standard output, a 
more detailed report is found in the y.output file. 


Because file names are fixed, at most one Yacc process can be active in a given directory at a 
time. 


II System CALLS 
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INTRODUCTION TO SYSTEM CALLS 


Section II of this manual lists all the entries into the system. In most cases two calling se- 
quences are specified, one of which is usable from assembly language, and the other from C. 
Most of these calls have an error return. From assembly language an erroneous call is always 
indicated by turning on the c-bit of the condition codes. The presence of an error is most 
easily tested by the instructions bes and bec (‘‘branch on error set (or clear)’’). These are 
synonyms for the dcs and dcc instructions. 


From C, an error condition is indicated by an otherwise impossible returned value. Almost 
always this is —1; the individual sections specify the details. 


In both cases an error number is also available. In assembly language, this number is re- 
turned in r0 on erroneous calls. From C, the external variable errno is set to the error 
number. Errno is not cleared on successful calls, so it should be tested only after an error has 
occurred. There is a table of messages associated with each error, and a routine for printing 
the message. See perror (I/1). 


The possible error numbers are not recited with each writeup in section II, since many errors 
are possible for most of the calls. Here is a list of the error numbers, their names inside the 
system (for the benefit of system-readers), and the messages available using perror. A short 
explanation is also provided. 


0 — (unused) 


l EPERM Not owner and not super-user 
Typically this error indicates an attempt to modify a file in some way forbidden except 
to its owner. It is also returned for attempts by ordinary users to do things allowed 
only to the super-user. 


2 ENOENT No such file or directory 
This error occurs when a file name is specified and the file should exist but doesn’l.. or 
when one of the directories in a path name does nol exist. 


3 ESRCH No such process 
The process whose number was given to signa/ does not exist, or is already dead. 


4 EINTR Interrupted system call 
An asynchronous signal (such as interrupt or quit), which the user has elected to catch, 
occurred during a system call. If execution is resumed after processing the signal, it 
will appear as if the interrupted system call returned this error condition. 


5 EIO I/O error 
Some physical I/O error occurred during a read or write. This error may in some cases 
occur on a call following the one to which it actually applies. 


6 ENXIO ~ No such device or address 
1/O on a special file refers to a subdevice which does not exist, or is beyond the limits 
of the allowed number of subdevices. It may also occur when, for example, a tape 
drive is not dialled in or no disk pack is loaded on a drive. 


7 E2BIG Arg list too long 
An argument list longer than 512 bytes (counting the null at the end of each argu- 
ment) is presented to exec. 
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8 


10 


1] 


13 


14 
15 


16 


17 


18 


19 


20 


tO 
to 


23 


ENOEXEC Exec format error 
A request is made to execute a file which, although it has the appropriate permissions, 
does not start with one of the magic numbers 407 or 410. 


EBADF Bad file number 
Either a file descriptor refers to no open file, or a read (resp. write) request is made to 
a file which is open only for writing (resp. reading). 


ECHILD No children | 
Wait was requested but the process has no living or unwaited-for children. 


EAGAIN No more processes 


In a fork, the system’s process table is full and no more processes can for the moment 
be created. 


ENOMEM Not enough core 

During an exec or break, a program asks for more core than the system is able to sup- 
ply. This is not a temporary condition, the maximum core size is a system parameter. 
The error may also occur if the arrangement of text, data, and stack segments | is such 
as to require more than the existing 8 segmentation registers. 


EACCES Permission denied 
An attempt was made to access a file in a way forbidden by the protection system. 


vunused) 


ENOTBLK Block device required 
A plain file was mentioned where a block device was required, e.g. in mount. 


I BUSY Mount device busy | : 
An attempt to mount a device that was already mounted or an attempt was made to 
dismount a device on which there is an open file or some process's current directory. 


EE XIST File exists 
An existing file was rnentioned in an inappropriate context, e.g. fink. 


EXDEV Cross-device link 
A link to a file on another device was attempted. 


ENODEV No such device | 
An attempt was made to apply an inappropriate system call to a device, e.g. read a 
write-only device. 


ENOTDIR Not a directory | . | 
A non-directory was specified where a directory is required, for example in a path 
name or as an argument to chdir. 


EISDIR Is a directory 

An attempt to write on a directory. 

FINVAL invalid argument 

Some invalid argument: currently, dismounting 4 non-mounted device, mentioning an 
unknown signal in signa/, and giving an unknown request in sity to the TIU special file, 
and passing an invalid argument list to exec. 


ENFILE File table overflow : 
The system’s table of open files is full, and temporarily no more opevs can be accepted. 
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24 EMFILE Too many open files 
Only 15 files can be open per process. 
25 ENOTTY Not a typewriter 
The file mentioned in sfty or gtty is not a typewriter or one of the other devices to 
which these calls apply. | | 
26 ETXTBSY Text file busy 
An attempt to execute a pure-procedure program which is currently open for writing 
(or reading!). Also an attempt to open for writing a pure-procedure program that is 
being executed. 
27 EFBIG File too large 
An attempt to make a file larger than the maximum of 32768 blocks. 
28 ENOSPC No space left on device 
During a write to an ordinary file, there is no free space left on the device. 
29 ESPIPE Seek on pipe 
A seek was issued to a pipe. This error should also be issuéd for other non-seekable 
devices. 
30 EROFS Read-only file system 
An attempt to modify a file or directory was made on a device mounted read-only. 
3] EMLINK Too many links 
An attempt to make more than 127 links to a file. 
32 EPIPE Write on broken pipe 


A write on a pipe for which there is no process to read the data. This condition nor- 
mally generates a signal; the error is returned if the signal is ignored. 
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NAME 
alarm — activate alarm clock timer 


SYNOPSIS 
(alarm = 27.; not in assembler) 
(seconds in r0) 
sys alarm 


alarm (seconds) 


DESCRIPTION 
Alarm returns immediately but starts a timer within the system which causes the alarm 
clock signal to be sent to the current process after the specified number of seconds 
have elapsed. The changing of the date via stime(II) does not cause the signal to be 
posted prematurely. | 


In assembly language, the old value of the timer (in seconds) is returned in r0. In C, 
that value is returned. 


SEE ALSO 
pause(II), sleep(II) 


DIAGNOSTICS 
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NAME 

break, brk, sbrk — change core allocation 
SYNOPSIS 

(break = 17.) 


sys break; addr 
char *brk (addr) 
char *sbrk (incr) 


DESCRIPTION 


Break sets the system’s idea of the lowest location not used by the program (called the 
break) to addr (rounded up to the next multiple of 64 bytes). Locations greater than 
addr and below the stack pointer are not in the address space and will thus cause a 
memory violation if accessed. 


From C, dbrk will set the break to addr. The old break is returned. 


In the alternate entry sbrk, incr more bytes are added to the program’s data space and 
a pointer to the start of the new area is returned. 


When a program begins execution via exec the break is set at the highest location 
defined by the program and data storage areas. Ordinarily, therefore, only programs 
with growing data areas need to use break. 


SEE ALSO 


exec (II), alloc (IJ), end (ID 


DIAGNOSTICS 


BUGS 


The c-bit is set if the program requests more memory than the system limit or if more 
than 8 segmentation registers would be required to implement the break. From C, —1 
is returned for these errors. 


Setting the break in the range 0177700 to 0177777 is the same as setting it to zero. 
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NAME ; 
chdir — change working directory 
SYNOPSIS 
(chdir = 12.) 
sys chdir; dirname 
chdir (dirname) 


char *dirname; 


DESCRIPTION 
Dirname is the address of the pathname of a directory, terminated by a null byte. 
Chdir causes this directory to become the current working directory. 


SEE ALSO 
chdir (1) 
DIAGNOSTICS 


The error bit (c-bit) is set if the given name is not that of a directory or is not read- 
able. From C, a —1 returned value indicates an error, 0 indicates success. 
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NAME 

chmod — change mode of file 
SYNOPSIS 

(chmod = 15.) 


sys chmod; name; mode 


chmod(name, mode) 
char *name; 


DESCRIPTION 
The file whose name is given as the null-terminated string pointed to by name has its 
mode changed to mode. Modes are constructed by ORing together some combination 
of the following: 


4000 set user ID on execution 

2000 set group ID on execution 

0400 read by owner 

0200 write by owner 

0100 execute (search on directory) by owner 
0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 


Only the owner of a file (or the super-user) may change the mode. 


SEE ALSO 
chmod (I) 


DIAGNOSTIC 
Error bit (c-bit) set if name cannot be found or if current user is neither the owner of 
the file nor the super-user. From C, a —1 returned value indicates an error, 0 indi- 
cates success. 
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NAME 

chown — change owner and group of a file 
SYNOPSIS 

(chmod = 16.) 


sys chown; name; owner 


chown(name, owner) 
char *name; 


DESCRIPTION 
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CHOWN (II) 


The file whose name is given by the null-terminated string pointed to by name oe its 
owner and group changed to the low and high bytes of owner respectively. Only the 
Super-user may execute this call, because if users were able to give files away, they 


could defeat the (nonexistent) file-space accounting procedures. 


SEE ALSO | 
chown (VIII), passwd (V) 


DIAGNOSTICS 


The error bit (c-bit) is set on illegal owner pcnanees: From Ca-l returned value indi- 


cates error, 0 indicates success. 
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NAME 
close — close a file 
SYNOPSIS 
(close = 6.) 
(file descriptor in r0) 
sys close 
close (fildes) 
DESCRIPTION 


Given a file descriptor such as returned from .an open, creat, or pipe call, close closes 
the associated file. A close of all files is automatic on exit, but since processes are lim- 
ited to 15 simultaneously open files, close is necessary for programs which deal with 
many files: 


SEE ALSO 
creat (II), open (II), pipe (ID) 


DIAGNOSTICS 
The error bit (c-bit) is set for an unknown file descriptor. From C a —1! indicates an 
error, 0 indicates success. 
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NAME 

creat — create a new file 
SYNOPSIS 

(creat = 8.) 


SyS creat; name; mode 
(file descriptor in r0) 


creat(name, mode) 
char *name; 


DESCRIPTION | | | 
Creat creates a new file or prepares to rewrite an existing file called name. given as the 
address of a null-terminated string. If the file did not exist, it is given mode mode. 
See chmod (II) for the construction of the mode argument. | 


If the file did exist, its mode and owner remain unchanged but it is truncated to 0 
length. 


The file is also opened for writing, and its file descriptor is returned (in r0). 


The mode given ts arbitrary; it need not allow writing. This feature is used by pro- 

- grams which deal with temporary files of fixed names. The creation is done with z 
mode that forbids writing. Then if a second instance of the program attempts a creat. 
an error is returned and the program knows that the name ts unusable for the mo- 
ment. | 


SEE ALSO ' 
write (II), close (II), stat (II) 

DIAGNOSTICS . . 
The error bit (c-bit) may be set if: a needed directory is not searchable; the file does 


not exist and the directory in which it is to be created is not writable; the file does ex- 
ist and is unwritable; the file is a directory; there are already too many files open. 


From C, a —1 return indicates an error. 
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NAME 
csw — read console switches 
SYNOPSIS 
(csw = 38.; not in assembler) 
SyS csw 
getcsw( ) 
DESCRIPTION 


The setting of the console switches is returned (in r0). 
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NAME 
dup — duplicate an open file descriptor 


SYNOPSIS 
(dup = 41.; not in assembler) 


(file descriptor in r0) 
sys dup 


dup (fildes) 
int fildes; 


DESCRIPTION 
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BUP CII) 


Given a file descriptor returned from an open, pipe, or creat call, dup will allocate 


another file descriptor synonymous with the original. 


turned in r0. 


The new file descriptor is re- 


Dup is used more to reassign the value of file descriptors than to genuinely duplicate a 
file descriptor. Since the algorithm to allocate file descriptors returns the lowest avail- 
able value, combinations of dup and close can be used to manipulate file descriptors in 
a general way. This is handy for manipulating standard input and/or standard output. 


SEE ALSO 
creat (II), open (II), close (ID), pipe (II) 


DIAGNOSTICS | 


The error bit (c-bit) is set if: the given file descriptor is invalid; there are already too 


many open files. From C, a —1 returned value indicates an error. 
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NAME 
exec, execl, execv — execute a file 
SYNOPSIS 
(exec = 11.) 


SyS exec; name; args 
name: <...\0> 


args: arg0; argl; ...; 0 
arg0: <...\0> | 
argl: <...\0> 


execl (name, arg0, argl, ..., argn, 0) 
char *name, *arg0, *argl, ..., “argn; 


execv (name, argv) 
char *name; 
char *argv| |: 


DESCRIPTION | 
Exec overlays the calling process with the named file, then transfers to the beginning 
of the core image of the file. There can be no return from the file; the calling core im- 
age 1S lost. | 


Files remain open across exec calls. Ignored signals remain ignored across exec, but 
signals that are caught are reset to their default values. 


Each user has a rea/ user ID and group ID and an effective user ID and group ID. The 
real ID identifies the person using the system; the effective ID determines his access 
privileges. Exec changes the effective user and group ID to the owner of the executed 
file if the file has the ‘‘set-user-ID”’’ or ‘‘set-group-ID’’ modes. The real user ID 1s 
not affected. 


The form of this call differs somewhat depending on whether it is called from assem- 
bly language or C; see below for the C version. 


The first argument to exec is a pointer to the name of the file to be executed. The 
second is the address of a null-terminated list of pointers to arguments to be passed to 
the file. Conventionally, the first argument is the name of the file. Each pointer ad- 
dresses a String terminated by a null byte. 


Once the called file starts execution, the arguments are available as follows. The stack 
pointer points to a word containing the number of arguments. Just above this number 
is a list of pointers to the argument strings. The arguments are placed as high as pos- 
sible in core. 


sp— nargs 
arg0 
argn 
—| 
argO: <arg0\0> 


aren: < argn\0> 


From C, two interfaces are available. exec/ is useful when a known file with known ar- 
guments is being called; the arguments to exec/ are the character strings constituting 
the file and the arguments; as in the basic call, the first argument is conventionally the 
same as the file name (or its last component). A 0 argument must end the argument 
list. | 
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The execy version is useful when the number of arguments is unknown in advance, 
tte arguments to execv are the name of the file to be executed and a vector of strings 
cofitaining the arguments. The last argument string must be followed by a 0 pointer. 


When a C program is executed, it is called as follows: 


main (argc, argv) 
int argc; 
char **argv; 


where argc is the argument count and argv is an array of character pointers to the ar- 
guments themselves. As indicated, argc is conventionally at least one and the first 
member of the array points to a string containing the name of the file. 


Argv is not directly usable in another execy, since argv/argc/ is —1 and not 0. 


SEE ALSO 


fork (II) 


DIAGNOSTICS 


BUGS 


If the file cannot be found, if it is not executable, if it does not have a valid header 
(407, 410, or 411 octal as first word), if maximum memory is exceeded, or if the argu- 
ments require more than 512 bytes a return from exec constitutes the diagnostic; the 
error bit (c-bit) is set. Even for the super-user, at least one of the execute-permission 


“bits must be set fora file to be executed. From C the returned value is —1. 


_ Only 512 characters of arguments are allowed. 
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NAME 
exit — terminate process 


SYNOPSIS 
(exit = 1.) 
(status in r0) 
SYS exit 


exit (status) 
int status; 


DESCRIPTION 
Exit is the normal means of terminating a process. Exit closes all the process’s files 
and notifies the parent process if it is executing a wait. The low byte of r0 (resp. the 
argument to exit) is available as status to the parent process. 


This call can never return. 


SEE ALSO 
wait (II) 


DIAGNOSTICS 
None. 
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fork — spawn new process 


SYNOPSIS 


(fork = 2.) 

sys fork 

(new process return) 
(old process return) 


fork ( ) 


DESCRIPTION 


Fork is the only way new processes are created. The ew process’s core image is a 
copy of that of the caller of fork. The only distinction is the return location and the 
fact that r0 in the old (parent) process contains the process ID of the new (child) pro- 
cess. This process ID is used by wait. % 


The two returning processes share all open files that existed before the call. In partic- 
ular, this is the way that standard input and output files are passed and also how pipes 
ar@aset up. 

From C, the child process receives a 0 return, and the parent receives a non-zero 
number which is the process ID of the child; a return of —1 indicates inability to create 
a new process. 


SEE ALSO 


wait (II), exec (II) 


DIAGNOSTICS 


The error bit (c-bit) is set in the old process if a new process could not be created be- 
cause of lack of process space. From C, a return of —1 (not just negative) indicates an 
error. 
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NAME 

fstat — get status of open file 
SYNOPSIS 

(fstat = 28.) 


(file descriptor in r0) 
sys fstat; buf 


fstat (fildes, buf) 
struct in.” *buf; 


DESCRIPTION 
This call is identical to stat, except that it operates on open files instead of files given 
by name. It is most often used to get the status of the standard input and output files, 
whose names are unknown. | 


SEE ALSO 
stat (II) 


DIAGNOSTICS 
The error bit (c-bit) is set if the file descriptor is unknown; from C, a —1 return indi- 


cates an error, O indicates success. 
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GETGID (TI) GETGYD (H) 
NAME 


getgid — get group identifications 


SYNOPSIS 
(getgid = 47.; not in assembler) 
Sys getgid 
getgid ( ) 


DESCRIPTION 
Getgid returns in r0 the real group ID of the current process. The real group ID 
identifies the group of the. person who is logged in, in contradistinction to the effective 
group ID, which determines his access permission at the moment. It is thus useful to 


programs which operate using the ‘‘set group ID” mode, to find out who invoked 
them. 


SEE ALSO 
setgid (II) 


DIAGNOSTICS 
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GETPID (IT) GETPID (II) 


NAME 
getpid — get process identification 


SYNOPSIS 
(getpid = 20.; not in assembler) 
SyS getpid 


(pid in r0) 
getpid( ) 
DESCRIPTION 
Getpid rex. 3 the process ID of the current process. Most often it is used to generate 
uniquely-named temporary files. 
SEE ALSO 
BUGS 


Process id’s wrap around at 65K and therefore may not be unique. — 
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GETUID (11) | GETUID.(H) 


NAME 
getuid — get user identifications 


SYNOPSIS 
(getuid = 24.) 
sys getuid 


getuid( ) 


DESCRIPTION 
Getuid returns in r0, the real user ID of the current process. The real user ID 
identifies the person ‘who is logged in, in contradistinction to the effective user ID, 
which determines his access permission at the moment. It is thus useful to programs 
which operate using the ‘‘set user ID’’ mode, to find out who invoked them. 


SEE ALSO 
setuid (II) 


DIAGNOSTICS 


Bell Telephone Laboratories, Incorporated -|- PA-1C300-01 


PROGRAM APPLICATION INSTRUCTION Section 2 
Issue 1, January 1976 


AT&TCo SPCS 


GTTY (II) GTTY (IT) 
NAME 

gity — get typewriter status 
SYNOPSIS 

(gtty = 32.) 


(file descriptor in r0) 
Sys gtty; arg 


arg: .> ‘6 


gtty (fildes, arg) 
int arg[3}]; 


DESCRIPTION | 
Gtty stores in the three words addressed by arg the status of the typewriter whose file 
descriptor is given in rO (resp. given as the first argument). The format is the same as 
that passed by s/ty. 


SEE ALSO 
stty (II) 


DIAGNOSTICS 
Error bit (c-bit) is set if the file descriptor does not refer to a typewriter. From C, a 
—1 value is returned for an error, 0, for a successful call. 
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INDIR (11) INDIR (11) 

NAME 


indir — indirect system call 


SYNOPSIS . 
(indir = 0.; not in assembler) 
sys indir; syscall 
DESCRIPTION 
Is system call at the location sysca// is executed. Execution resumes after the indir 
call. 


The main purpose of indir is to allow a program to store arguments in system calls and 
execute them out of line in the data segment. This preserves the purity of the text 
segment. 


If indir is executed indirectly, it is a no-op. If the instruction at the indirect location is 
not a system call, the executing process will get a fault. 


SEE ALSO 


DIAGNOSTICS 
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KILL (iT) KILL (IT) 


NAME 
kill — send signal to a process 


SYNOPSIS 
(kill = 37.; not in assembler) 
(process number in r0) 
sys kill; sig 


Kill(p.*. sig); 
DESCRIPTION 


Kill sends the signal sig to the process specified by the process number in r0. See sig- 
nal (II) for a list of signals. | 


The sending and receiving processes must have the same effective user ID, otherwise 
this call is restricted to the super-user. 


If the process number is 0, the signal is sent to all other processes which have the 
same controlling typewriter and user ID. 


In no case is it possible for a process to kill itself. 


SEE ALSO 
signal (11), kill (1) 


DIAGNOSTICS | 
The error bit (c-bit) is set if the process does not have the same effective user ID and 
the user is not super-user, or if the process does not exist. From C, —1 is returned. 
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LINK (11) LING Ci) 
NAME 
Hk — link to a file 
SYNOPSIS 
(link = 9.) 


sys link; namel; name2 


link(namel, name2) 
char *namel, *name?2; 


DESCRIPTION 
A link to name/ is created; the link has the name name2. Either name may be an arbitrary path 
name. 


SEE ALSO 
~ In (I), unlink GD 


DIAGNOSTICS 
The error bit (c-bit) is set when name/ cannot be found; when name2 already exists, when the 
directory of name2 cannot be written, when an attempt is made to link to a directory by a user 
other than the super-user, when an attempt is made to link to a file on another file system, 
when more than 127 links are made. From C, a —1 return indicates an error, a 0 return indi- 
cates success. 
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LOCK (II) LOCK (II) 


NAME 
lock — semaphores 


SYNOPSIS 
(lock = 62.:not in assembler) 
sys lock; function; flag 


function = 0 lock 
ll unlock 
2 tlock 
lock (flag, 
unlock (flag) 
tlock (flag) 


DESCRIPTION 
The primitives lock, unlock, and tlock operate on non-negative integer semaphores 
called flags. Lock, unlock, and tlock are used in conjunction with the semaphores to 
simplify the communication and synchronization of processes. 


lock (flag) Suspends the execution 
of the calling process while the 
semaphore is locked by another 
process. Otherwise the semaphore 
is locked. 


unlock (flag) Activates a suspended process 
waiting on the semaphore flag. 


tlock (flag) Tests the condition of the semaphore 
but does not suspend execution of 
the calling process. 
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MDATE (11) MDATE (11) 
NAME 

mdate — set modified date on file 
SYNOPSIS 

(mdate = 30.) 


(time to r0-r1) 
sys mdate; file 


mdate (file, time) 
char *file; 
int timel2]; 

DESCRIPTION 
File is the address of a null-terminated string naming a file; the modified time of the file is set 
to the time given in registers r0 and rl (resp. in the vector which is the second argument). See 
time (II) for the unit and epoch. 


This call is allowed only to the super-user or to the owner of the file. 


SEE ALSO 
time (II) 


DIAGNOSTICS 
Error bit is set if the user is neither the owner nor the super-user or if the file cannot be found. 
From C, a negative return indicates an error, a 0 return indicates success. 


BUGS 
Caution: setting back the date of a file probably will prevent it from being dumped by an incre- 


mental dump. 
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MKNOD (II) MKNOD (IT) 


NAME 
mknod — make a directory or a special file 


SYNOPSIS 
(mknod = 14.; not in assembler) 
sys mknod; name; mode; addr 


mknod(name, mode, addr) 
char *name; 


DESCRIPTION 
: Mknod creates a new file whose name is the null-terminated string pointed to by name. 
The mode of the new file (including directory and special file bits) is initialized from 
mode. The first physical address of the file is initialized from addr. Note that in the 
case of a directory, addr should be zero. In the case of a special file, addr specifies 
which special file. 


Mknod may be invoked only by the super-user. 


SEE ALSO 
mkdir (1), mknod (VIII, fs (V) 


DIAGNOSTICS 


Error bit (c-bit) is set if the file already exists or if the user is not the super-user. - 
From C, a —1 value indicates an error. 
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MOUNT (II) MOUNT (TE) 
NAME 


mount — mount file system 


SYNOPSIS 
(mount = 21.) 
SYS mount; special; name; rwflag 


mount (special, name, rwflag) 
char *special, *name; 


DESCRIPTION 
Mount announces to the system that a removable file system has been mounted on the 
block-structured special file special; from now on, references to file name will refer to 
the root file on the newly mounted file system. Special and name are pointers to null- 
terminated strings containing the appropriate path names. 


Name must exist already. Its old contents are inaccessible while the file system is 
mounted. 


The ruflag argument determines whether the file system can be written on; if it is 0 
writing 1s allowed, if non-zero no writing is done. Physically write-protected and mag- 
netic tape file systems must be mounted read-only or errors will occur when access 
times are updated, whether or not any explicit write 1s attempted. When a mount oc- 
curs, an open is issued to the pertinent device driver. 


SEE ALSO 
mount (VIII), umount (II) 


DIAGNOSTICS | 
Error bit (c-bit) set if: specia/ is inaccessible or not an appropriate file; name does not 
exist or is a special file; specia/ is already mounted; name is in use; there are already 
too many file systems mounted. 


BUGS 
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NICE (IT) NICE CIT) 
NAME 

nice — set program priority 
SYNOPSIS 

(nice = 34.) 

(priority in r0) 

Sys nice 


nice (priori*~"* 


DESCRIPTION 
The scheduling priority of the process is changed to the argument. Positive priorities 
get less service than normal; 0 is default. Only the super-user may specify a negative 
priority. The valid range of priority is 20 to —220. The value of 4 is recommended to 
users who wish to execute long-running programs without flak from the administra- 
tion. 


The effect of this call is passed to a child process by the fork system call. The effect 
can be cancelled by another call to nice with a priority of 0. 


The actual running priority of a process is the priority argument plus a number that 
ranges from 100 to 106 depending on the cpu usage of the process. 


SEEALSO. 
nice (I), ps(I) 


DIAGNOSTICS | 
The error bit (c-bit) is set if the user requests a priority outside the range of 0 to 20 
and is not the super-user. 
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OPEN (IT) OPEN (I) 
NAME 

open — open for reading or writing 
SYNOPSIS 

(open = 5.) 


SYS open; name; mede 
(file descriptor in r0) 


open(name, mode) 
char *name; 


DESCRIPTION 
Open opens the file name for reading (if mode is 0), writing (if mode is 1) or for both 
reading and writing (if mode is 2). Name is the address of a string of ASCII characters 
representing a path name, terminated by a null character. 


The returned file descriptor should be saved for subsequent calls to read, write, and 
close. 


SEE ALSO 
creat (II), read (II), write (II), close (II) 


DIAGNOSTICS 
The error bit (c-bit) is set if the file does not exist, if one of the necessary directories 
does not exist or is unreadable, if the file is not readable (resp. writable), or if too 
many files are open. From C, a —1 value is returned on an error. 
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PAUSE (II) | PAUSE (IT) 


NAME 
pause — suspend execution indefinitely 


SYNOPSIS 
(pause = 29.: not in assembler) 
sys pause 
pause () 


DESCRIPTION 
The current prv..ss is suspended from execution until any signal arrives. Pause will 
return immediately if no alarm has been set. 


SEE ALSO 
alarm (II) 


DIAGNOSTICS . 
Error bit (c-bit) is set upon return unless the pause failed because no alarm was set. 
From C, a —1 is returned normally, 0 if because no alarm was set. 
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NAME 
pipe — create an interprocess channel 
SYNOPSIS 
(pipe = 42.) 
SYS pipe 


(read file descriptor in r0) 
(write file descriptor in rl) 


pipe (fildes) 
int fildes[2]; 


DESCRIPTION 
The pipe system call creates an I/O mechanism called a pipe. The file descriptors re- 
turned can be used in read and write operations. When the pipe is written using the 
descriptor returned in rl (resp. fildes[1]), up to 4096 bytes of data are buffered before 
the writing process is suspended. A read using the descriptor returned in r0 (resp. 
fildes{0]) will pick up the data. 


It is assumed that after the pipe has been set up, two (or more) cooperating processes 
(created by subsequent fork calls) will pass data through the pipe with read and write 
calls. 


The Shell has a syntax to set up a linear array of processes connected by pipes. 


Read calls on an empty pipe (no buffered data) with only one end (all write file 
descriptors closed) return an end-of-file. Write calls under similar conditions generate 
a fatal signal (signal (II)); if the signal is ignored, an error is returned on the write. 


SEE ALSO 
sh (1), read (II), write (II), fork UD 


DIAGNOSTICS 
The error bit (c-bit) is set if too many files are already open. From C, a —1 returned 
value indicates an error. A Signal is generated if a write on a pipe with only one end ts 
attempted. 


BUGS 
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PROFIL CIT) PROFIL (IT) 
NAME 


profil — execution time profile 


SYNOPSIS 
(profil = 44.; not in assembler) 
SYS profil; buff; bufsiz; offset; scale 


profil (buff, bufsiz, offset, scale) 
che~ buffl |; 
int bu. ‘7 offset, scale; 


DESCRIPTION 
Buff points to an area of core whose length (in bytes) is given by bufsiz. After this 
call, the user’s program counter (pc) is examined each clock tick (60th second); offset 
is subtracted from it, and the result multiplied by scale. If the resulting number 
corresponds to a word inside buff, that word is incremented. 


The scale is interpreted as an unsigned, fixed-point fraction with binary point at the 
left: 177777(8) gives a 1-1 mapping of pc’s to words in buff: 77777(8) maps each pair 
of instruction words together. 2(8) maps all instructions onto the beginning of bu/f 
(producing a non-interrupting core clock). 


Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by giving a 
bufsiz of 0. Profiling is also turned off when an exec is executed but remains on in 
child and parent both after a fork. 


SEE ALSO 
monitor (III), prof (1) 


DIAGNOSTICS 
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READ (1H) READ (11) 
NAME 


read — read from file 


SYNOPSIS 
(read = 3.) 
(file descriptor in r0) 
sys read; buffer; nbytes 


read (fildes, buffer, nbytes) 
char *buffer; 


DESCRIPTION | 
A file descriptor is a word returned from a successful open, creat, dup, or pipe call. 
Buffer is the location of nbytes contiguous bytes into which the input will be placed. It 
is not guaranteed that all ndytes bytes will be read; for example if the file refers to a 
typewriter at most one line will be returned. In any event the number of characters 
read is returned (in r0). | 


If the returned value is 0, then end-of-file has been reached. 


SEE ALSO | 
open (II), creat (II), dup (II), pipe (II) 


DIAGNOSTICS 
As mentioned, 0 is returned when the end of the file has been reached. If the read 
was otherwise unsuccessful the error bit (c-bit) is set. Many conditions can generate 
an error: physical I/O errors, bad buffer address, preposterous nbdytes, file descriptor 
not that of an input file. From C, a —1 return indicates the error. 
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SEEK (IT) SEEK (II) 
NAME 

seek — move read/write pointer 
SYNOPSIS 3 

(seek = 19.) 


(file descriptor in r0) 
sys seek; offset; ptrname 


seek (fi: 3es. offset, ptrname) 


DESCRIPTION 


The file descriptor refers to a file open for reading or writing. The read (resp. write) 
pointer for the file is set as follows: 


if ptrname is 0, the pointer ts set to offset. 
if ptrname is 1, the pointer is set to its current location plus offset. 
if ptrname is 2, the pointer is set to the size of the file plus offset. 


if ptrname is 3, 4 or 5, the meaning is as above for 0, 1 and 2 except that the offset 
is multiplied by $12. 


If ptrname is 0 or 3, offset is unsigned, otherwise it is signed. 


SEE ALSO 
open (II), creat (II) 


DIAGNOSTICS 


The error bit (c-bit) is set for an undefined file descriptor. From C, a —1 return indi- 
cates an error. 
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NAME 
setgid — set process group ID 
SYNOPSIS 
(setgid = 46.; not in assembler) 
(group ID in r0) 
Sys Setgid 


setgid (gid) 
DESCRIPTION 7 


PA-1C300-01] 
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SETGID (If) 


The group ID of the current process is set to the argument. Both the effective and the 
real group ID are set. This call is only permitted to the super-user or if the argument 


is the real group ID. 


SEE ALSO | 
getgid (II) 


DIAGNOSTICS 


Error bit (c-bit) is set as indicated; from C, a —1 value is returned. 
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SETUID (II) SETUID (II) 


NAME 
setuid — set process user ID 


SYNOPSIS 
(setuid = 23.) 
(user ID in r0) 
SYS setuid 


setuid (uid) 


DESCRIPTION 
The user 1. .f the current process is set to the argument. Both the effective and the 
real user ID are set. This call is only permitted to the super-user or if the argument is 
the real user ID. 


SEE ALSO 
getuid (II) 


DIAGNOSTICS 
Error bit (c-bit) is set as indicated; from C, a —1 value is returned. 
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SIGNAL (II) ) | SIGNAL (ID) 


NAME 
signal — catch or ignore signals 


SYNOPSIS 
(signal = 48.) | 
Sys signal; sig; label 
(old value in r0) 


signal (sig, func) 
int (*func) (); 


DESCRIPTION : ) | 
A signalis generated by some abnormal event, initiated either by a user at a typewriter 
(quit, interrupt), by a program error (bus error, etc.), or by request of another pro- 
gram (kill). Normally all signals cause termination of the receiving process, but this 
call allows them either to be ignored or to cause an interrupt to a specified location. 
Here is the list of signals: 


l hangup 

2 interrupt (reboot, or delete key) 

3* = quit (ascii FS) 

4* illegal instruction (not reset when caught) 
5* trace trap (not reset when caught) 

6* JOT instruction 

7* ~~ EMT instruction 

8* floating point exception 

9 kill (cannot be caught or ignored) 
10* bus error 

11* segmentation violation 

12" bad argument to system call 

13. write on « pipe with no one to read it 
14 alarm timeout 


14 untuse:! 
; unused 
1; unused 


ig unused 
19 unused 


In the assembier call. if /gbe/ is C, the process is terminated when the signal occurs; 
this is the default action. If /aAey is odd, the signal is ignored. Anv other even /ahel 
specifies an address in the process where an interrupt is simulated. An RTI] or RTT 
instruction wiil return from the interrupt. Except as indicated, a signal is reset to 0 
after being caught. Thus if it 1s desired to catch every such signal, the catching routine 
must issue another saval call. 


In C, if func is YU, the default action for signal sig (termination) is reinstated. If func is 
1, the signai is ignored. If fic is non-zero and even, it is assumed to be the address 
of a function cntry point. When the signal occurs, the function will be called. A re- 
turn from the function will continue the process at the point it was interrupted. As in 
the assembler call, s:gva/ must in general be called again to catch subsequent signals. 


When a caught signal occurs during certain system calls, the call terminates premature- 
ly. In particular this can occur during a read or write on a slow device (like a typewrit- 
er, Dui noi a fie), and during or wait. When such a signal occurs, the saved user 
Status 1S arranged in such a way that when return from the signal-catching takes place, 
it will appear thai the system call returned a characteristic error status. The user's pro- 
gram may then, if it wishes, re-execute the call. 


The starred signals in the list above cause a core image if not caught or ignored. 
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SIGNAL (TT) SIGNAL (CII) 


The value returned by the signal call is the old action defined for the signal. 


After a fork (II) the child inherits all signals. Exec (II) resets all caught signals to de- 
fault action but allows inheritance of ignored signals. 


SEE ALSO 
kill (1), kill (II), reset (IID) 


DIAGNOSTICS ro | 
The error bit (c-bit) is set if the given signal is out of range. In C, a —1 indicates an 
error; ot“erwise indicates success. 


BUGS 


Bell Telephone Laboratories, Incorporated -l- ~ PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section 2 
Issue 1, January 1976 

AT&TCo SPCS | 


SLEEP (II) SLEEP (II) 


NAME 
sleep — stop execution for interval 


SYNOPSIS 
(sleep = 35.; not in assembler) 
(seconds in r0) 
Sys sleep 


sleep (seconds) 


DESCRIPTION | 
The current process is suspended from execution for the number of seconds specified 
by the argument. This is implemented by adding the current date to the argument to 
produce a new date. The process is then suspended until the new date is reached. 


From C, s/eep is implemented by using signal(II) to catch the aiarm clock signal, then 
using alarm(II) and pause(II) to set up and wait for the alarm to occur after the 
number of seconds specified by the argument. The treatment of the alarm clock signal 
by the calling program is preserved, but any alarm currently in progress is cleared. 


SEE ALSO 
sleep(I), alarm(II), pause(II) 


DIAGNOSTICS 
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STAT (II) STAT (IT) 


NAME 

stat — get file status 
SYNOPSIS 

(stat = 18.) 


sys Stat; name; buf 


stat(name, buf) 
char *name; 
struct inode § “f: 


DESCRIPTION 
Name points to a null-terminated string naming a file; buf is the address of a 36(10) 
byte buffer into which information is placed concerning the file. It is unnecessary to 
have any permissions at all with respect to the file, but all directories leading to the file 
must be readable. After stat, buf has the following structure (starting offset given in 


bytes): 

struct inode { 
char minor; /* +0: minor device of i-node */ 
char major; /* +1: major device */ 
int inumber; /* +2 */ 
int flags; /* +4: see below */ 
char _ nilinks; /* +6: number of links to file */ 
char uid; /* +7: user ID of owner */ 
char gid; /* +8: group ID of owner */ 
char size0; /* +9: high byte of 24-bit size */ 
int sizel: /* +10: low word of 24-bit size */ 
int addr[8]; /* +12: block numbers or device number */ 
int actime[2]- /* +28: time of last access */ 
int modtime[2], /* +32: time of last modification */ 


ie 
The flags are as follows: 


100000 _ 1-node is allocated 
060000 2-bit file type: 
. 000000 _—ipitain file 
040000 _=—s directory 
020000 _ character-type special file 
060000 i block-type special file. 
010000 large file 
004000 set user-ID on execution 
002000 set group-ID on execution 
001000 save text image after execution 
000400 read (owner) 
000200 =write (owner) 
000100 execute (owner) 
000070 ~—sread, write, execute (group) 
000007 _—sread, write, execute (others) 


SEE ALSO 
Is (1), fstat (ID, fs (V) 
DIAGNOSTICS 


Error bit (c-bit) is set if the file cannot be found. From C, a —I return indicates an 
error. 
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STIME(II) ~ STIME (II) 
NAME 
stime — set time 
SYNOPSIS 
(stime = 25.) 
(time in r0-rl) 
Sys stime 
stime (tbuf) 
int tbuf[2]; 
DESCRIPTION 


Stime sets the system’s idea of the time and date. Time is measured in seconds from 
0000 GMT Jan 1 1970. Only the super-user may use this call. 


SEE ALSO 
date (J), time (II), ctime (III) 


DIAGNOSTICS | 
Error bit (c-bit) set if user is not the super-user. 
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STTY (II) STTY (II) 
NAME 
' gstty — set mode of typewriter 
SYNOPSIS 
(stty = 31.) 


(file descriptor in r0) 
Sys stty; arg 


arg: .byte ..--ed, ospeed; 0; mode 


stty (fildes, arg) 

struct { 
char ispeed, ospeed; 
int unused; 
imt mode; 

} *arg; 


DESCRIPTION 
Stty sets mode bits and character speeds for the typewriter whose file descriptor is 
passed in r0 (resp. is the first argument to the call). First, the system delays until the 
typewriter is quiescent. The input and output speeds are set from the first two bytes 
of the argument structure as indicated by the following table, which corresponds to the 
speeds supported by the DH-11 interface. If DC-11, DL-11 or KL-11 interfaces are 
used, impossible speed changes are ignored. : 


(hang up dataphone) 
50 baud 
75 baud 
110 baud 
134.5 baud 
150 baud 
200 baud 
300 baud 
600 baud 
1200 baud 
10 1800 baud 
11 2400 baud 
12 4800 baud 
13 9600 baud 
14 External A 
15 External B 


In the current configuration, only 110, 150 and 300 baud are really supported on dial- 
up lines, in that the code conversion and line control required for IBM 2741's (134.5 
baud) must be implemented by the user’s program, and the half-duplex line discipline 
required for.the 202 dataset (1200 baud) is not supplied. 


The second word of the argument structure is currently unused and reserved for fu- 
ture use. 


WO od IHN & WG NO — © 


The mode contains several bits which determine the system’s treatment of the type- 
writer: 


100000 Select one of two algorithms for backspace delays 

040000 Select one of two algorithms for form-feed and vertical-tab delays 
030000 Select one of four algorithms for carriage-return delays 

006000 Select one of four algorithms for tab delays 

001400 Select one of four algorithms for new-line delays 

000200 even parity allowed on input (e. g. for M37s) 

000100 odd parity allowed on input | 
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000040 raw mode: wake up on all characters 

000020 map CR into LF; echo LF or CR as CR-LF 
000010 echo (full duplex) 

000004 map upper case to lower on input (e. g. M33) 
000002 echo and print tabs as spaces 


The delay bits specify how long transmission stops to allow for mechanical or other 
movement when certain characters are sent to the terminal. In all cases a value of 0 
indicates no delay. 


Backspace delays are currently ignored.but will be used for Terminet 300’s. 
If a form-feed/vertical tab delay is specified, it lasts for about 2 seconds. 


Carriage-return delay type | lasts about .08 seconds and is suitable for the Terminet 
300. Delay type 2 lasts about .16 seconds and is suitable for the VT05 and the TI 700. 
Delay type 3 is not implemented and is 0. 


New-line delay type 1 is dependent on the current column and is tuned for Teletype 
model 37’s. Type 2 is useful for the VTOS and is about .10 seconds. Type 3 is not im- 
plemented and is 0. 


Tab delay type 1 is dependent on the amount of movement and is tuned to the Tele- 
type model 37. Other types are unimplemented and are 0. 


Characters with the wrong parity, as determined by bits 200 and 100, are ignored. 


In raw mode, every character iS passed immediately to the program without waiting 
until a full line has been typed. No erase or kill processing is done; the end-of-file 
character (EOT), the interrupt character (DEL) and the quit character (FS) are not 
treated specially. 


Mode 020 causes input carriage returns to be turned into new-lines; input of either CR 
or LF causes LF-CR both to be echoed (used for GE TermiNet 300’s and other termi- 
nals without the newline function). 


This system call is also used with certain special files other than typewriters, but since 
none of them are part of the standard system the specifications will not be given. 


SEE ALSO 
stty (1), gtty (ID 


DIAGNOSTICS 
The error bit (c-bit) is set if the file descriptor does not refer to a typewriter. From C, 
a negative value indicates an error. | 
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SYNC (ID) SYNC (II) 


NAME 
sync — update super-block 


SYNOPSIS 


(sync = 36.; not in assembler) 
sys sync 
DESCRIPTION 


Sync causes all information in core memory that should be on disk to be written out. 
This inc: :des modified super blocks, modified i-nodes, and delayed block I/O. 


It should be .. 2d by programs which examine a file system, for example icheck, df, 
etc. It is mandatory before a boot. 


SEE ALSO 
sync (VIII), update (VIII) 


DIAGNOSTICS 
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TIME (IT) | TIME (11) 


NAME 3 . 
time — get date and time 


SYNOPSIS 
(time = 13.) 
sys time 


time (tvec) 
int tvec([2]; 


DESCRIPTION | 
Time returns the time since 00:00:00 GMT, Jan. 1, 1970, measured in seconds. From 
as, the high order word is in the rO register and the low order is in rl. From C, the 
user-supplied vector is filled in. 


SEE ALSO 
date (I), stime (II), ctime (IID 


DIAGNOSTICS 
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NAME 


times — get process times 


SYNOPSIS 


(times = 43.; not in assembler) 
Sys times; buffer 


times (buffer) 
struct tbuf*-r *bufifer; 


DESCRIPTION 


Times returns time-accounting information for the current process and for the ter- 
minated child processes of the current process. All times are in 1/60 seconds. 


After the call, the buffer will appear as follows: 


struct tbuffer { 

int proc_user_time; 

int proc_system_time; 

int child user_time[2I: 
int child_system_time(2]; 


}; 
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TIMES (IT) 


The children times are the sum of the children’s process times and their children’s 


times. 


SEE ALSO 


time (I) 


DIAGNOSTICS 


BUGS 


The process times should be 32 bits as well. 
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NAME | 
umount — dismount file system 
SYNOPSIS 


(umount = 22.) 
Sys umount; ee 


DESCRIPTION 
Umount announces to + hie system that special file special is no longer to contain a re- 
movable file system. A close is issued to the pertinent device driver. The file associat- 
ed with the special file reverts to its ordinary interprétation; see mount (II). 


SEE ALSO 
umount (VIII), mount (ID 


DIAGNOSTICS a . . 
Error bit (c-bit) set if no file system was mounted on the special file or if there are still 
active files on the mounted file system. 
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UNLINK (TT) UNLINK (HI) 


NAME 
unlink — remove directory entry 


SYNOPSIS 
(unlink = 10.) 
SyS unlink; name 


unlink (mame) 
char “name; 


DESCRIPTION 
Name points to a null-terminated string. Unlink removes the entry for the file pointed 
to by name from its directory. If this entry was the last link to the file, the contents of 
the file are freed and the file is destroyed. If, however, the file was open in any pro- 
cess, the actual destruction is delayed until it is closed, even though the directory en- 
try has disappeared. 


SEE ALSO 
rm (I), rmdir (I), link (ID) 


DIAGNOSTICS 
The error bit (c-bit) is set to indicate that the file does not exist or that its directory 
cannot be written. Write permission is not required on the file itself. It is also illegal 
to unlink a directory (except for the Hapeeecd). From C, a —1 return indicates an er- 
ror. - 
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NAME 
wait — wait for process to terminate 
SYNOPSIS 
(wait = 7.) 
sys wait 
(process ID in r0) 
(status in rl) 
wait (status) 
int *status; 
DESCRIPTION 
Wait causes its caller to delay until one of its child processes terminates. If any child 
has died since the last wait, return is immediate; if there are no children, return is im- 
mediate with the error bit set (resp. with a value of —1 returned). The normal return 
yields the process ID of the terminated child (in r0). In the case of several children 
several wait calls are needed to learn of all the deaths. 
If no error is indicated on return, the rl high byte (resp. the high byte stored into 
status ) contains the low byte of the child process r0 (resp. the argument of exit ) when 
it terminated. The rl (resp. status ) low byte contains the termination status of the 
process. See signal (II) for a list of termination statuses (signals); 0 status indicates 
normal termination. If the 0200 bit of the termination status is set, a core image of 
the process was produced by the system. 
If the parent process terminates without waiting on its children, the initialization pro- 
cess (process ID = 1) inherits the children. 
SEE ALSO 
exit (II), fork (II), signal (ID 
DIAGNOSTICS 


The error bit (c-bit) is set if there are no children not previously waited for. From C, 
a returned value of —1 indicates an error. 
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WRITE (i) WRITE (15) 
NAME 

write — write on a file 
SYNOPSIS 

(write = 4.) 


(file descriptor in r0) 
sys write; bufier; nbytes 


write (fides, buffer, nbytes) 
char “bu.” > 


DESCRIPTION 
A file descriptor is a word returned from a successful open, creat, dip, or pipe call. 


Buffer is the address of nbytes contiguous bytes which are written on the output file. 
The number of characters actually written is returned (in r0). It should be regarded as 
an error if this is not the same as requested. 


Writes which are multiples of 512 characters long and begin on a 512-byte boundary in 
the file are more efficient than any others. 


SEE ALSO 
creat (11), open (II), pipe (ID) 


DIAGNOSTICS 
The error bit (c-bit) is set on an error: bad descriptor, buffer address, or count; physi- 


cal I/O errors. From C, a returned value of —1 indicates an error. 


TIT] SuprouTines 
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ABORT (HII) ABORT (IIH) 


NAME 
abort — generate an IOT fault 


SYNOPSIS 
abort 0 


DESCRIPTION 
Abort executes the IOT instruction. This is usually considered a program fault by the 
system and results in termination with a core dump. It is used to generate a core im- 
age for dc ‘ging. 


SEE ALSO | 7 
db (1), cdb (1), signal (11) 


DIAGNOSTICS 
usually “‘IOT trap -- core dumped’’ from the Shell. 


BUGS 
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NAME 
abs, fabs — absolute value 


SYNOPSIS 
abs (i) 
int i; 


double fabs (x) 
double x; 


DESCRIPTION 


PA-1C300-01 

Section 3 

Issue 1, January 1976 
AT&TCo SPCS 


ABS (IIT) 


Abs returns the absolute value of its integer operand; fabs is the double version. 
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NAME 


alloc — core allocator 


SYNOPSIS 


char “alloc(size) 


free (ptr) 
char “ptr; 


DESCRIPTION 


Alloc and fre. ‘vide a simple general-purpose core management package. Alloc 1s 
given a Size In Dyics; it returns a pointer to an area at least that size which is even and 
hence can hold an object of any type. The argument to /ree is a pointer to an area pre. 
vious allocated by alloc; this space is made available for further allocation. 


Needless to say, grave disorder will result if the space assigned by a//oc is overrun or if 
some random number ts handed to /ree. 


The method uses a first-fit algorithm which coalesces blocks being freed with other 
blocks already free. It calls sbrk (see break (1)) to get more core from the sysiem 
when there is no suitable space already free. If that fails, it writes “‘Out of space’’ on 
the standard output and exits. 


The external variable s/op (which is 2 if not set) is a number such that if » bytes are 
requested, and if the first free block of size at least is no larger than »+s/op, then 
the whole block will be allocated instead of being split up. Larger values of s/op tend 
to reduce fragmentation at the expense of unused space in the allocated blocks. 


DIAGNOSTICS 


BUGS 


‘‘Out of space’’ if it needs core and can’t get it. 
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NAME 


atan, atan2 — arc tangent function 


SYNOPSIS 
jsr pc,atan 
jsr pc,atan2 
double atan (x) 
double x; 


double atan2(x, y) 
double x, y; 


DESCRIPTION 
The atan entry returns the arc tangent of fr0 in fr0; from C, the arc tangent of x is re- 
turned. The range is —7/2 to 7/2. The atan2 entry returns the arc tangent of fr0/frl 
in frO; from C, the arc tangent of x/y is returned. The range is —7 to 7. 


DIAGNOSTIC 
There is-no error return. 


BUGS 


ye 
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ATOF (III) ATOF (IIT) 


NAME 
atof — convert ASCII to floating 


SYNOPSIS 
double atof(nptr) 
char *nptr; 


DESCRIPTION 
Atof convrts a string to a floating number. Noptr should point to a string containing 
the numbe:, ‘ first unrecognized character ends the number. 


The only numbers recognized are: an optional minus sign followed by a string of di- 
gits optionally containing one decimal point, then followed optionally by the letter e 
followed by a signed integer. 


DIAGNOSTICS 
There are none; overflow results in a very large number and garbage characters ter- 
minate the scan. 


BUGS 
The routine should accept initial +, initial blanks, and E for e. Overflow should be 
signalled. 
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NAME 
atoi — convert ASCII to integer 
SYNORSIS 
atoi(nptr) 


char *nptr; 


DESCRIPTION 
Atoi converts the string pointed to by nptr to an integer. The string can contain leading 
blanks or tabs, an optional ‘—’, and then an unbroken string of digits. Conversion 
stops at the first non-digit. | 


SEE ALSO 
atof (III) 


BUGS 
There is no provision for overflow. 
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NAME 
compar — default comparison routine for qsort 


SYNOPSIS 
sr pc,compar 


DESCRIPTION 
Compar is the default comparison routine called by gsort and is separated out so that the user 
can supp:.’ his own comparison. 


The routine 1s _. ‘ed with the width (in bytes) of an element in 13 and it compares byte-by-byte 
the element pointed to by r0 with the element pointed to by r4. 


Return is via the condition codes, which are tested by the instructions ‘“‘bit’’ and ‘‘bgt’’. That 
is, in the absence of overflow, the condition (r0) < (r4) should leave the Z-bit off and N-bit on 
while (r0) > (r4) should leave Z and N off. Still another way of putting it is that for elements 
of length 1 the instruction 


cmpb  (r0),(r4) 
suffices. 
Only r0 is changed by the call. 


SEE ALSO 
qsort (III) 


BUGS 
It could be recoded to run faster. 
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NAME 
crypt — password encoding 


SYNOPSIS 
mov $key,r0 
jst _— pc, crypt 
char *crypt (key) 
char *key; 


DESCRIPTION 
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CRYPT (fii) 


On entry, r0 points to a string of characters terminated by an ASCII NUL. The 
routine performs an operation on the key which is difficult to invert (i.e. encrypts it) 
and leaves the resulting eight bytes of ASCII alphanumerics in a global cell called 


‘‘word’’. 


From C, the key argument is a string and the value returned is a pointer to the eight- 


character result. 


This routine is used to encrypt all passwords. 


SEE ALSO 


passwd (I), passwd (V), login (I) 


BUGS 


Short or otherwise simple passwords can be decrypted easily by exhaustive search. Six 
characters of gibberish is reasonably safe. 
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NAME 


ctime, localtime, gmtime — convert date and time to ASCII 


SYNOPSIS 


char *ctime(tvec) 
int tvec[2]; 


[from Fortran] 
double precision ctime 
. = ctimew  ~my) 


int *localtime(tvec) 
int tvec({2]: 


int *gmtime(tvec) 
int tvec(2]: 


DESCRIPTION 


Ctime converts a time in the vector tvec such as returned by time (II) into ASCII and 
returns a pointer to a character string in the form 


Sun Sep 16 01:03:52 1973\n\0 
All the fields have constant width. 


The /ocaltime and gmtime entries return pointers to integer vectors containing the 
broken-down time. Localtime corrects for the time zone and possible daylight savings 
time; gimtime converts directly to GMT, which is the ttme UNIX uses. The value is a 
pointer to an array whose components are 


seconds 

minutes 

hours | 

day of the month (1-31) 

month (0-11) 

year — 1900 

day of the week (Sunday = 0) 

day of the year (0-365) 

Daylight Saving Time flag if non-zero 


co SION ON B&B WN © 


The external variable timezone contains the difference, in seconds, between GMT and 
local standard time (in EST, it is 5*60*60); the external variable daylight is non-zero if 
the standard U.S.A. Daylight Savings Time conversion should be applied. The pro- 
gram knows about the peculiarities of this conversion in 1974 and 1975; if necessary, a 
table for these years can be extended. 


A routine named crime is also available from Fortran. Actually it resembles more the 
time (II) system entry in that it returns the number of seconds since the epoch 0000 
GMT Jan. 1, 1970 (as a floating-point number). 


SEE ALSO 


BUGS 


time (II) 
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NAME 
dtol — floating point to double precision integer conversion 
SYNOPSIS 
dtol (d,¢) 
double d; 
int ¢{2]; 
DESCRIPTION 


Dtol converts the floating point number d to a double precision (i.e. long) integer. 
The fractional part of the floating point number is lost during conversion; hence dro/ (d,t) and 
dtol ( floor (d),t) yield the same results. 


SEE ALSO 
Itod (HI) floor (ID) 
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NAME 


ecvt, fevt — output conversion 


SYNOPSIS 


jsr pc,ecvt 
jsr pe,fevt 


char *ecvt(value, ndigit, decpt, sign) 
double valuc: 

int ndigit, *dec, *sign; 

char *fcvt (value, ndigit, decpt, sign) 


DESCRIPTION 


SEE AL 


BUGS 


Ecvt is called with a floating point number in fr0. 


On exit, the number has been converted into a string of ascii digits in a buffer pointed 
to by r0. The number of digits produced is controlled by a global variable _ndigits. 


Moreover, the position of the decimal point is contained in r2: r2=0 means the d.p. is 
at the left hand end of the string of digits; r2>0 means the d.p. is within or to the 
right of the string. 


The sign of the number is indicated by rl (0 for +; 1 for —). 
The low order digit has suffered decimal rounding (i. e. may have been carried into). 


From C, the value is converted and a pointer to a null-terminated string of ndigit digits 
is returned. The position of the decimal point is stored indirectly through decpt (nega- 
tive means to the left of the returned digits). If the sign of the result is negative, the 
word pointed to by sign is non-zero, otherwise it is zero. 


Fcvt is identical to ecvt, except that the correct digit been rounded for F-style output of 
the number of digits specified by ndigits. 


SO 
printf (III) 
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END Ct) | END CHE) 


NARI 
end, ciext, edata — last locations im program 


SYNOPSIS 
extern enmels 
extern etext; 
extern edata; 


DESCRIPTION 
These names refer neither to routines nor to locations with interesting contents. In- 
stead, their addresses coincide with the first address above the program {text region 
(eiexi), above the initialized data region (edata), or uninitialized data region (ena). 
The last is the same as the program break. Values are given to these symbols by the 
link editor /d (@) when, and only when, they are referred to but not defined in the set 
of programs loaded. 


The usage of these symbols is rather specialized, but one plausible possibility is 
extern end; | 


-_. = brk(&end+...): 


(see break (II)). The problem with this is that it ignores any other subroutines which 
may want to extend core for their purposes; these include sbrk (see break (II)), alloc 
(II), and also secret subroutines invoked by the profile (—p) option of cc. Of course 
it was for the benefit of such systems that the symbols were invented, and user pro- 
grams, unless they are in firm control of their environment, are wise not to refer to 
the absolute symbols direcily. 


One technique sometimes useful is to call sbrk(0), which returns the value of the 
current program break, instead of referring to &end, which yields the program break at 
the instant execution started. 


These symbols are accessible from assembly language if it is remembered that they 
should be prefixed by *_’ 


SEE ALSO 
break CD), alloc (11) 


BUGS 
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EXP (TIT) EXP (IIT) 


NAME 
exp — exponential function 


' SYNOPSIS 


jsr pc,exp 


double exp(x) 
double x; 


DESCRIPTION . 
The expone... *' of fr0 is returned in frO. From C, the exponential of x is returned. 


DIAGNOSTICS . 
If the result is not representable, the c-bit is set and the largest positive number is re- 
turned. From C, no diagnostic is available. 


Zero is returned if the result would underflow. 


BUGS 
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NAME 
floor, ceil — floor and ceiling functions 

SYNOPSIS: 
double. floor(x) 
double x; 
double ceil (x) 
double x; 

DESCRIPTION . — . 
The floor function returns the largest integer (as a double precision: number): not 
gteater than x. | 
The ceil function returns the smallest integer not less than x, 


BUGS 
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FMOD (TIT) FMOD (III) 


NAME 
fmod — floating modulo function 


SYNOPSIS 3 
double fmod (x, y) 
double x, y; 


DESCRIPTION | 
Fmod returns the number /such that x = iy + f ‘is an integer, and 0 < f< y. 


BUGS 
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FPTRAP (1H) FPTRAP (111) 
NAME 


fptrap — floating point interpreter 


SYNOPSIS 
SyS signal; 4; fptrap 


DESCRIPTION 
Fptrap is a sirnulator of the 11/45 FP11-B floating point unit. It works by intercepting 
illegal instruction traps and decoding and executing the floating point operation codes. 


FILES 
In systems with real floating point, there is a fake routine in /lib/liba.a with this name; 
when simulation is desired, the real version should be put in liba.a. 


DIAGNOSTICS 
A break point trap is given when a real illegal instruction trap occurs. 


SEE ALSO 

| signal (II), cc (I) (‘—f’ option) 

BUGS 

Rounding mode is not interpreted. It’s slow. 
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GAMMA (III) | GAMMA (III) 


NAME 
gamma — log gamma function 


SYNOPSIS 
jsr pc,gamma 


double gamma (x) 
double x; 


DESCRIPTION 
If x is passed (in fr0) gamma returns In |['(x)| (in fr0). The sign of ['(x) is returned 
in the external integer signgam. The following C program might be used to calculate 


y = gamma(x); 
if (y > 88.) 
error( ); 
y = exp(y); 
if(signgam) 
y= =, 
DIAGNOSTICS 


The c-bit is set on negative integral arguments and the maximum value ts returned. 
There is no error return for C programs. 


BUGS 
No error return from C., 
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NAME 


getarg, iargc — get command arguments from Fortran __ 


SYNOPSIS 
call getarg (i, iarray [ , isize ] ) 


= iargc(dummy) 


DESCRIPTION 
The getarg entry fills in iarray (which is considered to be integer) with fies Hollerith 
string representing the / th argument to the command in which. it it is called. If no 
isize argument is specified, at least one blank is placed after the argument, and the last 
word affected is blank padded. The user should make sure that the array is big 
enough. 


If the isize argument is given, the argument will be followed by blanks to fill up isize 
words, but even if the argument is long no more than that ‘many words will be filled 
in. 


The blank-padded array is suitable for use as an argument to 'setfil (iD. 


The /argc entry returns the number of arguments to the command, ames the first 
(file- name) argument. | 


SEE ALSO 
| exec (II), setfil (I) 


BUGS 


Bell Telephone Laboratories, Incorporated -l- PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section 3 


Issue 1, January 1976 
AT&TCo SPCS 
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NAME 


getc, getw, fopen — buffered input 


SYNOPSIS 


mov. $filename,r0 
jsr r5,fopen; iobuf 


fopen (filename, iobuf) 
char *filename; 
struct buf *iobuf; 


jsr r5,getc; iobuf 
(character in r0) 


getc(iobuf) 
struct buf *iobuf; 


jsr r5,getw; iobuf 
(word in r0) 


getw (iobuf) 
struct buf *iobuf; 


DESCRIPTION 


These routines provide a buffered input facility. /obufis the address of a 518(10) byte 
buffer area whose contents are maintained by these routines. Its structure is 


struct buf { 

int fildes; /* File descriptor */ 

int nleft; /* Chars left in buffer */ 

char *nextp; /* Ptr to next character */ 

char buff[512]; /* The buffer */ 
Fopen may be called initially to open the file. On return, the error bit (c-bit) is set if 
the open failed. If /fopen is never called, ges will read from the standard input file. 
From C, the value is negative if the open failed. 


Getc returns the next byte from the file in r0. The error bit is set on end of file or a 
read error. From C, the character is returned as an integer, without sign extension; It 
is —1 on end-of-file or error. 


Getw returns the next word in r0. Gefc and getw may be used alternately; there are no 
odd/even problems. Getw may be called from C; —1 is returned on end-of-file or er- 
ror, but of course ts also a legitimate value. 


fobuf must be provided by the user; it must be on a word boundary. 


To reuse the same buffer for another file, it is sufficient to close the original file and 
call fopen again. 


SEE ALSO | : 


open (II), read (II), getchar (III), pute (III) 


DIAGNOSTICS 


BUGS 


c-bit set on EOF or error; from C, negative return indicates error or EOF. Moreover, 
errno iS set by this routine just as it is for a system call (see introduction (II)). 
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NAME 
getchar — read character 
SYNOPSIS 
getchar() 
DESCRIPTION 


Getchar provides the simplest means of reading characters from the standard <apul for 
C programs. It returns successive characters until end-of-file, whén it returns *\0”’. 


Associated with this routine is an external variable calfed jin, Which 7s a structure con- 
taining a buffer such as described under getc (III). 


Generally speaking, getchar should be used only for the simplest sopncaiones getc is 
better when there are multiple input files. 


SEE ALSO 
getc (III) 


DIAGNOSTICS 
Null character returned on EOF or error. 


BUGS 
—1 should be returned on EOF; null is a legitimate character. 
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NAME 
getpw — get name from UID 


SYNOPSIS 
getpw (uid, buf) 
char “*buf; 


DESCRIPTION 7 
Getpw searches the password file for the (numerical) wid, and fills in buf with the 
corresponding line; it returns non-zero if wid could not be found. The line is null- 
terminated. 


FILES 
/etc/passwd 


SEE ALSO 
passwd (V) 


DIAGNOSTICS 
non-zero return on error. 


BUGS 
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HMUL (EEE) 
NAME 
hmul — high-order product 
SYNOPSIS 
hmul(x, y) 
DESCRIPTION 


PA-1C390-01 
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HMUL (HII) 


Hmul returns the high-order 16 bits of the product of x and y. (The binary multiplica- 


tion operator generates the low-order 16 bits of a product.) 


BUGS 
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NAME 
hypot — calculate hypotenuse 


SYNOPSIS 
jsr r5,hypot 


DESCRIPTION 
The square root of frO x fr0 + frl xfrl is returned in fr0. The calculation is done in 
such a way that overflow will not occur unless the answer is not representable in float- 
ing point. 


DIAGNOSTICS : 
The c-bit is set if the result cannot be represented. 


BUGS 
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NAME 


ierror — catch Fortran errors 


SYNOPSIS 


if (ierror ( errno) .ne. 0) goto /abel 


DESCRIPTION 


lerror provides a way of detecting errors dutiie the. running of a es program. Its 
argument is a run-time error number such as enumerated in /c (1). , - 


When error is called, it returns a 0 value; thus the goto statement in the synopsis is 
not executed. However, the routine stores inside itself the call point and invocation 
level. If and when the indicated error occurs, a return is simulated from ierror with a 
non-zero value; thus the goto (or other statement) is executed. It is a ghastly error to 
call ierror from a subroutine which has already returned when the error occurs. 


This routine is essentially tailored to catching end-of-file situations. Typically it is 
called just before the start of the loop which reads the input file, and the goto jumps to 
a graceful termination of the program. 


There is a limit of 5 on the number of different error numbers which can be caught. 


SEE ALSO 


BUGS 


fc (I) 


There is no way to ignore errors. 
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NAME 
Idiv, lrem — long division 


SYNOPSIS 
idiv (hidividend, lodividend, divisor) 
Irem (hidividend, lodividend, divisor) 
DESCRIPTION 
The concatenation of the signed 16-bit hidividend and the unsigned 16-bit /odividend is 
divided by divisor. The 16-bit signed quotient is returned by /div and the 16-bit signed 


remainder is returned by /rem. Divide check and erroneous results will occur unless 
the magnitude of the quotient is less than 32768. 


An integer division of an unsigned dividend by a signed divisor may be accomplished 
by 


quo = lIdiv(0, dividend, divisor); 
and similarly for the remainder operation. 


Often both the quotient and the remainder are wanted. Therefore /div leaves a 
remainder in the external cell /divr. 


BUGS 
No check on divide check. 
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NAME 
locv. — long output conversion 
SYNOPSIS 


char *locv (hi, lo) 
int hi, lo; 


DESCRIPTION a e ota. | 
Locv converts a signed double-precision integer, whose parts are passed as arguments, 
to the equivalent ASCII character string and returns a pointer to:that string, — 


SEE ALSO 
atof (III), atoi (III) 


BUGS ; | 
Since /ocv returns a pointer to a static buffer containing the converted result, it cannot 
be used twice in the same expression; the second result overwrites the first. 
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LOG (TIT) LOG (IIT). 


NAME 
log — natural logarithm 


SYNOPSIS 
jsr pc, log 


double log (x) 
double x; 


DESCRIPTION . | 
The natural logarithm of frO is returned in frO. From C, the natural logarithm of x is 
returned. 


DIAGNOSTICS . 
The error bit (c-bit) is set if the input argument is less than or equal to zero and the 
result is a negative number very large in magnitude. From C, there is no error indica- 
tion. 


BUGS 
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LTOD (III) LTOD (IH) 


NAME 
ltod — double precision integer to floating point conversion 


SYNOPSIS 
double Itod (t) 
int t{2); 


DESCRIPTION 


Ltod converts a signed double pisceion encase integer to the equivalent poaung: point 
number. . tots = | : | 


SEE ALSO 
dtol (IID 
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NAME 
mesg — write message on typewriter 
SYNOPSIS 4 
jsr r5,mesg; < Now is the time\0>; .even 
DESCRIPTION 


Mesg writes the string immediately following its call onto the standard output file. The string 
must be terminated by an ASCII NULL byte. 


BUGS 
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NAME 
mktemp — make a unique named tempcrary file 


SYNOPSIS 
mktemp (as) 
char *as; 


DESCRIPTION | . 3 
Mktemp creates a unique named temporary file. The name is made up of the string pointed to 
by as where each ’X’ is replaced by a digit formed from the process identification. If the named 
file already exists the letters ’a’, ’b’, ... are added as the last letter and the name is tried again. 


Mktemp returns a pointer to the unique name. If all the letters of the alphabet are exhausted 
without successfully creating a unique name the name ’/’ is returned. 


BUGS 


Bell Telephone Laboratories, Incorporated -|- PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section 3 
Issue 1, January 1976 

AT&TCo SPCS 


MONITOR (IIT) MONITOR (IIT) 


NAME 
monitor — prepare execution profile 


SYNOPSIS 
monitor(lowpc, highpc, buffer, bufsize) 
int lowpe(), highpc( ), bufferl J, bufsize; 


DESCRIPTION | 
Monitor is an interface to the system’s profile (II) entry. Lowpc and highpc are the 
names of two functions; buffer is the address of a (user supplied) array of bu/size in- 
tegers. Monitor arranges for the system to sample the user’s program counter periodi- 
cally and record the execution histogram in the buffer. The lowest address sampled is 
that of /owpc and the highest is just below highpc. For the results to be significant, 
especially where there are small, heavily used routines, it is suggested that the buffer 
be no more than a few times smaller than the range of locations sampled. 


To profile the entire program, it is sufficient to use 
extern etext; 


monitor (2, &etext, buf, bufsize); 
Etext is a loader-defined symbol which lies just above all the program text. 
To stop execution monitoring and write the results on the file mon.ourt, use 
monitor (0); 
Then, when the program exits, prof (I) can be used to examine the results. 


It is seldom necessary to call this routine directly; the —p option of cc is simpler if one 
is satisfied with its default profile range and resolution. 


FILES 
mon.out 


SEE ALSO 
prof (I), profil (ID, cc (D 
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NAME 
nargs — argument count 
SYNOPSIS 
nargs( ) 
DESCRIPTION 


Nargs returns the number of actual parameters supplied by the caller of the routine 
which calls nargs. | 


The argument count is accurate only when none of the actuat parameters is float or 
double. Such parameters count as four arguments instead of one. 


BUGS 
As indicated. This routine does not work (and cannot be made to work) in programs 
with separated I and D space. Altogether it is best to avoid using this routine and 
depend, for example, on passing an explicit argument count. 
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NAME 
nlist — get entries from name list 


SYNOPSIS 
nlist (filename, nl) 
char *filename; 


struct { 
char name[8]; 
int type; 


int value; 


} nll}; 


DESCRIPTION 
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NLIST (CHIT) 


Nlist examines the name list in the given executable output file and selectively extracts 
a list of values. The name list consists of a list of 8-character names (null padded) 
each followed by two words. The list is terminated with a null name. Each name is 
looked up in the name list of the file. If the name is found, the type and value of the 
name are placed in the two words following the name. If the name is not found, the 


type entry is set to —1. 


This subroutine is useful for examining the system name list kept in the file /unix. In 
this way programs can obtain system addresses that are up to date. 


SEE ALSO 
a.out (V) 


DIAGNOSTICS 


All type entries are set to —1 if the file cannot be found or if it is not a valid namelist. 


BUGS 
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NAME 2 
perror, sys_errlist, sys nerr, errno — system error messages | 
SYNOPSIS | 
perror(s) 
char *s; 
int sys nerr; 
char “sys errlistl]; 
int errno; 
DESCRIPTION | 
Perror produces a short error message describing the last error encountered during a 
call to the system from aC program. First the argument string s is printed, then a 
colon, then the message and a new-line. Most usefully, the argument string is the 
name of the program which incurred the error. The error number is taken from the 
external variable errno, which is set when errors occur but not cleared when non- 
erroneous calls are made. | 
To simplify variant formatting of messages, the vector of message strings sys_errlist is 
provided; errno can be used as an index in this table to get the message string without 
the newline. Sys_nerr is the largest message number provided for in the table; it 
should be checked because new error codes may be added to the system before they 
are added to the table. 
SEE ALSO 


Introduction to System Calls 
BUGS 
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NAME _ 
pow — floating exponentiation 


SYNOPSIS 
movf x,fr0 
movf_ y,fri 
jsr pc,pow 


double pow (x,y) 
. double x, y; 


DESCRIPTION 
Pow returns the value of x’ (in fr0). Pow(0.0, y) is 0 for any y. Pow(—x, y) returns a result 
only if y is an integer. 


SEEALSO 
exp (III), log UII) 


DIAGNOSTICS | 
The carry bit is set on return in case of overflow, pow(0.0, 0.0), or pow(—x, y) for non-integral 
y. From C there is no diagnostic. 


BUGS 
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NAME 
printf — formatted print 


SYNOPSIS 
printf(format, arg,, ...); 
char *format; 


DESCRIPTION 
Print/ converts, formats, and prints its arguments after the first under control of the first argu- 
ment. The first argument is a character string which contains two types of objects: plain charac- 
ters, which are simply copied to the output stream, and conversion specifications, each of which 
Causes conversion and printing of the next successive argument to printf. 


Each conversion specification is introduced by the character %. Following the %, there may be | 


99 


— an optional minus sign ‘‘-- 
the indicated field: 


— an optional digit string specifying a field width; if the converted argument has fewer char- 
acters than the field width it will be blank-padded on the left (or right, if the left- 
adjustment indicator has been given) to make up the field width, ee oe 


which specifies /ef/i adjustment of the converted argument in 


98 


— an optional period **.”’ which serves to separate the field width from the next digit string; 


— an optional digit string (precision) which specifies the number of digits to appear after the. 
decimal point, for e- and f-conversion, or the maximum number of characters to be 
printed from a String; 


— a character which tndicates the type of conversion to be applied.. 
The conversion characters and their meanings are 


d 


O 

x The integer argument is converted to decimal, octal, or hexadecimal notation respective- 
ly. 

{ The argument is converted to decimal notation in the style ‘‘{—]ddd.ddd’’ where the 
number of d's after the decimal point is equal to the precision specification for the argu- 
ment. If the precision is missing, 6 digits are given; if the precision is explicitly 0, no di- 
gits and no decimal point are printed. The argument should be float or double. 


e The argument is converted in the style ‘**[—]d.ddde+dd’’ where there is one digit before 
the decimal point and the number after is equal to the precision specification for the ar- 
gument;, when the precision is missing, 6 digits are produced. The argument should be a 
fioat or double quantity. 


¢ The argument character ts printed. 


s The argument is taken to be a string (character pointer) and characters from the string 
are printed until a null character or until the number of characters indicated by the preci- 
sion specification is reached, however if the precision is 0 or missing, all characters up to 
a null are printed. 


| The argument is taken to be an unsigned integer which ts converted to decimal and 
printed (the result will be in the range 0 to 65535). 


If no recognizable character appears after the %, that character is printed, thus % may be print- 
ed by use of the string %%. In no case does a non-existent or small field width cause truncation 
of a field. padding takes place only if the specified field width exceeds the actual width. Charac- 
ters generated by printf are printed by calling putchar. 


SEE ALSO 
putchar (II) 
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PRINTF (IIT) 


BUGS 


Very wide fields (>128 characters) fail. 
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NAME 
putc, putw, fcreat, fflush — buffered output 


SYNOPSIS 
mov $filename,r0 
jsr r5,fcreat; iobuf 


fcreat (file, iobuf) 
char “file; 
struct buf “iobuf; 


(put byte in r0) 
jsr r5,putec; iobuf 


putc(c, iobuf) 

int c; 

Struct buf *iobuf; 
(put word in rQ) 

jsr r5,putw; iobuf 


putw (w, iobuf); 

int w; 

struct buf *iobuf; 

jsr r5,flush; iobuf 


fflush (iobuf) 
struct buf *iobuf; 


DESCRIPTION 
. Fcreat creates the given file (mode 666) and sets up the buffer iobuf (size 518 bytes); 
putc and putw write a byte or word respectively onto the file; flush forces the contents 
of the buffer to be written, but does not close the file. The structure of the buffer is: 
struct buf { 
int fildes; /* File descriptor */ 
int nunused; /* Remaining slots */ 
char *xfree; /* Ptr to next free slot */ 
char buff[512]; /* The buffer */ 
9 
Before terminating, a program should call flush to force out the last of the output 
(flush from C). 


The user must supply jobuf, which should begin on a word boundary. 


To write a new file using the same buffer, it suffices to call ///flush, close the file, and 
call fcreat again. 


SEE ALSO 
creat (II), write (II), getc (III) 


DIAGNOSTICS | 
Fcreat sets the error bit (c-bit) if the file creation failed (from C, returns —1). Putc 
and putw return their character (word) argument. In all calls errno is set appropriately 
to 0 or to a system error number. See intro (II). 


BUGS 
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PUTCHAR (TIT) : PUTCHAR (IIT) 


NAME 


putchar, flush — write character 


SYNOPSIS 


putchar (ch) 
flush ( ) 


DESCRIPTION 


Putchar writes out its argument and returns it unchanged. Only the low-order byte is 
written, and only if it is non-null. Unless other arrangements have been made, 
putchar writes in unbuffered fashion on.the standard output file. 


Associated with this routine is an external variable four which has the structure of a 
buffer discussed under putc (III). If the file descriptor part of this structure (first 
word) is greater than 2, output via putchar is buffered. To achieve buffered output 
one may Say, for example: 


fout = dup(1); or 
fout = creat(...): 


In such a case flush must be called before the program terminates in order to flush out 
the buffered output. Flush may be called at any time. 


SEE ALSO 


BUGS 


putc (III) 


The fout notion is questionable. 
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NAME 
qsort — quicker sort 


SYNOPSIS 
qsort (base, nel, width, compar) 
char *base; 
int (*compar) (); 


DESCRIPTION | 7 
Qsort is an implementation of the quicker-sort algorithm. The first argument is a 
pointer to the base of the data; the second is the number of elements; the third is the 
width of an element in bytes; the last is the name of the comparison routine. It is 
called with two arguments which are pointers to the elements being compared. The 
routine must return an integer less than, equal to, or greater than 0 according to 
whether the first argument is to be considered less than, equal to, or greater than the 
second. | 


SEE ALSO 
sort (I) 


BUGS 
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NAME 
rand, srand —.random number generator 


SYNOPSIS 
(seed in r0) 
isr pc,srand /to initialize 


isr pc,rand /to get a random number 


srand (seed) 
int seed; 


rand( ) 


DESCRIPTION . 
: Rand uses a multiplicative congruential random number generator to return successive 
pseudo-random numbers (in r0) in the range from 0 to 2°°—1. 


The generator is reinitialized by calling srand with 1 as argument (in r0). It can be set to a ran- 
dom starting point by calling srand with whatever you like as argument, for example the low- 
order word of the time. | 


BUGS 
The low-order bits are not very random. 
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NAME 
reset, setexit — execute non-local goto 
SYNOPSIS 
setexit( ) 
reset ( ) 
DESCRIPTION | | | 
These routines are useful for dealing with errors and interrupts encountered in a low- 
level subroutine of a program. 
Setexit saves its stack environment in a static place for later use by reset. 
Reset restores the environment saved by the last call of setexit. It then returns in such 
a way that execution continues as if the call of setexit had just returned. All accessible — 
data have values as of the time reset was called. 
The routine that called sefexit must still be active when reset is called. 
SEE ALSO 


signal (II) 
BUGS 
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NAME 
setfil — specify Fortran file name 


SYNOPSIS 
call setfil ( unit, hollerith-string ) 


DESCRIPTION 
Setfil provides a primitive way to associate an integer I/O wnit number with a file 
named by the hollerith-string. The end of the file name is indicated by a blank. Subse- 
quent I/O on this unit number will refer to the file whose name is specified by the 
string. 
Setfil should be called only before any I/O has been done on the wnit, or just after do- 
ing a rewind or endfile. It is ineffective for unit numbers 5 and 6. 


SEE ALSO 
fo (I) 


BUGS 
The exclusion of units 5 and 6 is unwarranted. 
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NAME 


sin, cos — trigonometric functions 


SYNOPSIS 
jsr _— pc, sin (cos) 


double sin (x) 
double x; 


double cos (x) 
double x; 


DESCRIPTION | 
The sine (cosine) of fr0 (resp. x), measured in radians, is returned (in fr0). 


The magnitude of the argument should be checked by the caller to make sure the 
result is meaningful. 


BUGS 
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NAME 
sqrt — square root function 


SYNOPSIS 
jst pe,sqrt 


double sqrt (x) 


double x; 
DESCRIPTION | . 
The square root of fr0 (resp. x) is returned (in fr0).. 
DIAGNOSTICS . 5 ne 
The c-bit is set on negative arguments and 0 is returned. There is no error return for 
C programs. 
BUGS 


No error return from C. 
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NAME 


ttyn — return name of current typewriter 


SYNOPSIS 
jsr pc,ttyn 


ttyn (file) 
‘DESCRIPTION | 
Ttyn hunts up the last character of the name of the typewriter which is the standard in- 


put (from as) or is specified by the argument file Pore peae (from C). If is returned, 
the typewriter name is then ‘‘/dev/ttyn’’. 


x is returned if the indicated file does not correspond to a typewriter. 
BUGS 


IV DRIVERS | 
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DC (IV) DC (IV ) 


NAME 
dc — DC-11 communications interface 


DESCRIPTION 
The discussion of typewriter I/O given in tty (IV) applies to these devices. 


The DC-11 typewriter interface operates at any of four speeds, independently settable 
for input and output. The speed is selected by the same encoding used by the dh (IV) 
device (enumerated in stty (I1)); impossible speed changes are ignored. 


FILES | 
/dev/tty? 


SEE ALSO 
tty (IV), stty (II), dh (IV), gtty (ID) 


BUGS 
Although impossible speed changes are not attempted on the hardware, the software is 
quite willing to accept them and alter the software state of the device accordingly. 
Subsequent requests for the device’s state (gtty (II)) provide an erroneous status. 
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DH (IV) DH (IV) 
NAME 


dh — DH-11 communications sii 


DESCRIPTION tbe 
Each line attached to the DH-11 communications multiplexer behaves as deseribed’ in 
tty (IV). Input and output for each line may a teense be set to run at any of 16 
speeds; see séty (II) for the encoding. —— 


FILES 
/dev/tty? 


SEE ALSO 
tty (IV), stty (ID) 


BUGS 
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NAME 
dn — DN-11 ACU interface 


DESCRIPTION 
The dn? files are write-only. The permissible codes are: 


0-9 dial 0-9 | 
— 8 second delay for second dial tone 


The entire telephone number must be presented in a single write system call. 


FILES 
/dev/dn? 


SEE ALSO 
dp (IV) 


BUGS 
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DP (iV) ; | DP (IV) 
NAME 


dp — DP-11 201 data-phone interface 


DESCRIPTION 
The dp0 file is a 201 data-phone interface. Read and write calls to dp0 are limited to a max- 
imum of 512 bytes. Each write call is sent as a single record. Seven bits from each byte are 
written along with an eighth odd parity bit. The sync must be user supplied. -Each:read call re- 
turns characters received from a single record. Seven bits are returned. unaltered; the eighth bit 
is set if the byte was not received in odd parity. A 5-second time-out is set and a zero-byte 
record is returned if nothing is received in that time. 


FILES 
/dev/dp0 


SEE ALSO 
dn (IV) 


BUGS 
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HP (IV) HP (IV) 


NAME 
hp — RH-11/RP04 moving-head disk 


DESCRIPTION 
The files ApO, ..., hp7 refer to sections of RP disk drive 0. The files Ap8, ..., hp/5 refer 
to drive 1 etc. This is done since the size of a full RP drive is 170,544 blocks and 
internally the system is only capable of addressing 65536 blocks. Since the disk is so 
large, this allows it to be broken up into more manageable pieces. 


The origin and size of the pseudo-disks on each drive are as follows: 


disk start length cylinder 
0 0 9614 Othru 23 
24 thru 43 free 
18392 65535 44 thru 200 
83600 65535 201 thru 357 
14964420900 358 thru 407 
408 thru 410 free 
0 40600 0 thru 97 
41800 40600 100 thru 197 
83600 40600 201 thru 298 
12540040600 300 thru 397 


It is unwise for all of these files to be present in one installation, since there is overlap 
in addresses and protection becomes a sticky matter. 


The Ap files access the disk via the system’s normal buffering mechanism and may be 
read and written without regard to physical disk records. There is also a ‘“‘raw’’ inter- 
face which provides for direct transmission between the disk and the user’s read or 
write buffer. A single read or write call results in exactly one I/O operation and there- 
fore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RP files begin with rhp and end with a number which selects the 
same disk section as the corresponding Ap file. 


IHN a G2 RQ = 


In raw I/O the buffer must begin on a word boundary, and counts should be a multi- 
ple of 512 bytes (a disk block). Likewise seek calls should specify a multiple of 512 
bytes. 


FILES 
/dev/hp?, /dev/rhp? 


BUGS 
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NAME 
hs — RH11/RS03-RS04 fixed-head disk file 
DESCRIPTION 


The files AsO, ..., hs7 refer to RJSO3 disk drives 0 through 7. The files As8, ..., Asl5 
refer to RJSO4 disk drives 0 through 7. The RJSO3 drives are each 1024 blocks: long 
and the RJS04 drives are 2048 blocks long. 


The hs files access the disk via the system’s normal buffering mechanism and may be 
read and written without regard to physical disk records. There is also a ‘“‘raw’’ in- 
teface which provides for direct transmission between the disk and the user’s read or 
write buffer. A single read or write call results in exactly one I/O operation and there- 
fore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw HS files begin with rhs. The same minor device considerations hold 
for the raw interface as for the normal interface. 


In raw I/O the buffer must begin on a word boundary, and counts should be a multi- 
ple of 512 bytes (a disk block). Likewise seek calls should specify a multiple of 512 
bytes. 


FILES 
/dev/hs?, /dev/rhs? 


BUGS 
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HT (IV) | HT (IV) 
NAME 
ht — RH-11/TU-16 magtape interface 
DESCRIPTION 
The files mt? refer to the DEC RH/TM/TU16 magtape and have the following mean- 
ing: 
mt0, ..., mt3 800 bpi, rewind 
mt4, ..., mt7 800 bpi, no rewind 
mt8, ..., mtll 1600 bpi, rewind 
mt12, ..., mt15 1600 bpi, no rewind 


When a rewind mt file is closed, the tape is rewound; if it was open for writing, a dou- 
ble end-of-file is written first. Conversely, the tape is not rewound for a no-rewind mt 
file; a single end-of-file is written if the file was open for writing. By judiciously choos- 
ing mt files, it is possible to handle multi-file tapes. 


A standard tape consists of a series of 512-byte records terminated by a double end-' 
of-file. To the extent possible (even though it is inefficient), the system allows the 
tape to be treated like any other file. Seeks have their usual meaning and it is possible 
to read or write a byte at a time. 


The mt files discussed above are useful when it is desired to access the tape in a way 
compatible with ordinary files. When foreign tapes are to be dealt with, and especially 
when long records are to be read or written, the ‘‘raw’’ interface is appropriate. The 
associated files are named rmtod, ..., rmt7 and rmt8, ..., rmt/5. Each read or write call 
reads or writes the next record on the tape. In the write case the record has the same 
length as the buffer given. During a read, the record size is passed back as the 
number of bytes read, provided it is no greater than the buffer size; if the record is 
long, an error is indicated. In raw tape I/O, the buffer must begin on a word boun- 
dary and the count must be even. Seeks are ignored. An error is returned when a 
tape mark is read, but another read will fetch the first record of the new tape file. 


FILES 
/dev/mt?, /dev/rmt? 


SEE ALSO 
tp (I), mtm (1) 


BUGS 
The magtape system is supposed to be able to take 64 drives. Such addressing has 
never been tried. In fact, with the mapping above, four drives are the most ever sup- 
ported. 


If any non-data error is encountered, it refuses to do anything more until closed. 
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NAME 
kl — KL-11 or DL-11 asynchronous interface 


DESCRIPTION | | 
The discussion of typewriter I/O given in tty (IV) applies to these devices. 


Since they run at a constant speed, attempts to change the speed via stty (II) are ig- 
- nored. | 


The on-line console typewriter is interfaced using a KL-11 or DL-11. By appropriate 
switch settings during a reboot, UNIX will come up as a single-user system with I/O 
on the console typewriter. 


FILES» 
/dev/tty8 console 


SEE ALSO 
tty (IV), init (VIID 


BUGS 
Modem control for the DL-11E is not implemented. 


There is a built-in notion of upper case on the console which causes problems with the 
LA36. | | - 9% : 
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LP (IV) | LP (IV) 


NAME 
Ip — line printer 


DESCRIPTION 
Lp provides the interface to any of the standard DEC line printers. When it is opened 
or closed, a suitable number of page ejects is generated. Bytes written are printed. 


An internal parameter within the driver determines whether or not the device is treat- 
ed as having a 96- or 64-character set. In half-ASCII (64-character) mode, lower case 
letters are turned into upper case and certain characters are escaped according to the 
following table: 


oN 


Ib I> 


The driver correctly interprets carriage returns, backspaces, tabs, and form feeds. A 
sequence of newlines which extends over the end of a page is turned into a form feed. 
Lines longer than 80 characters are truncated. This number is a parameter in the 
driver. 


FILES 
/dev/I\p 


SEE ALSO 
Ipr (1) 


BUGS 
ae mode and the maximum line length should be set-able by a call analogous 
to stty UI). 


If the first characters written are newlines, they are thrown away. 
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NAME 
mem, kmem, null — core memory 


’ DESCRIPTION 
Mem is a special file that is an image of the core memory of the computer. It may be 
used, for example, to examine, and even to patch the system using the debugger. 


-A memory address is an 18-bit quantity which is used directly as a UNIBUS address. 
References to non-existent locations cause errors to be returned. 


Examining and patching device registers is likely to lead to unexpected results when 
read-only or write-only bits are present. 


The file kmem is the same as mem except that kernel virtual memory rather than phy- 
sical memory is accessed. In particular, the I/O area of kmem is located beginning at 
160000 (octal) rather than at 760000. The 1K region beginning at 140000 (octal) i 
the system’s data for the current process. It should be kept in mind that in systems 
with separate I (Instruction) and D (Data) space, the mapping for the file kmem is 
done through the kernel’s D space registers. 


The file nu/! returns end-of-file on read and ignores write. 


FILES 
/dev/mem, /dev/kmem, /dev/null 
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NAME 
pc — PC-11 paper tape reader/punch 
DESCRIPTION 
Ppt refers to the PC-11 paper tape reader or punch, depending on whether it is read or 
written. 


When ppt is opened for writing, a 100-character leader is punched. Thereafter each 
byte written is punched on the tape. No editing of the characters is performed. When 
the file is closed, a 100-character trailer is punched. 


When ppt is opened for reading, the process waits until tape is placed in the reader and 
the reader is on-line. Then requests to read cause the characters read to be passed 
back to the program, again without any editing. This means that several null leader 
characters will usually appear at the beginning of the file. Likewise several nulls are 
likely to appear at the end. End-of-file is generated when the tape runs out. 


Seek calls for this file are meaningless. 


FILES 
/dev/ppt 


BUGS 
If both the reader and the punch are open simultaneously, the trailer is sometimes not 
punched. Sometimes the reader goes into a dead state in which it cannot be opened. 
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NAME 
rf — RF11/RS11 fixed-head disk file 


DESCRIPTION 7 ee ; 
: This file refers to the concatenation of all RS-11 disks. 


Each disk contains 1024 256-word blocks. The length of the combined RF file is 
1024x(minor+1) blocks. 7 7 - , 


The r/0 file accesses the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a ‘‘raw’’ interface which pro- 
vides for direct transmission between the disk and the user’s read or write buffer. A single read 
or write call results in exactly one I/O operation and therefore raw I/O is considerably more 
efficient when many words are transmitted. The name of the raw RF file is rr/0. The same 
minor device considerations hold for the raw interface as for the normal interface. 


In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 
bytes (a disk block). Likewise seek calls should specify a multiple of 512 bytes. 


FILES 
. /dev/rf0, /dev/rrf0 


The 512-byte restrictions on the raw device are not physically necessary, but are still imposed. 
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RK (IV) RK (IV) 


NAME 
rk — RK-11/RKO03 (or RKOS) disk 


DESCRIPTION 
Rk? refers to an entire RKO3 disk as a single sequentially-addressed file. Its 256-word 
blocks are numbered 0 to 4871. 


Drive numbers (minor devices) of eight and larger are treated specially. Drive 8+ is 
the x+1 way of interleaving devices rkO to rkx. Thus blocks on rk10 are distributed 
alternately among rkO, rkl, and rk2. 


The rk files discussed above access the disk via the system’s normal buffering mechan- 
ism and may be read and written without regard to physical disk records. There is also 
a “‘raw’’ interface which provides for direct transmission between the disk and the 
user’s read or write buffer. A single read or write call results in exactly one I/O opera- 
tion and therefore raw I/O is considerably more efficient when many words are 
transmitted. The names of the raw RK files begin with rrk and end with a number 
which selects the same disk as the corresponding rk file. 


In raw I/O the buffer must begin on a word boundary, and counts should be a multi- 
ple of 512 bytes (a disk block). Likewise seek calls should specify a multiple of 512 
bytes. 


FILES 
/dev/rk?, /dev/rrk? 


BUGS 
Care should be taken in using the interleaved files. First, the same drive should not 
be accessed simultaneously using the ordinary name and as part of an interleaved file, 
because the same physical blocks have in effect two different names; this fools the 
sana een Strategy. Second, the combined files cannot be used for swapping 
or raw 


Bell Telephone Laboratories, Incorporated -]-. PA-1C300-01 


PROGRAM APPLICATION INSTRUCTION : a - Section | 
Issue 1, January 1976 
AT&TCo SPCS 
RP (IV) RP (IV) 
NAME 
rp — RP-11/RP03 moving-head disk 
DESCRIPTION 


The files rp0, ..., rp7 refer to sections of RP disk drive 0; the files rp8, ..., ronJ5 refer to | 
drive 1; etc. This i is done since the size of a full RP drive i is 81200 blocks and internal- 
ly the system is only capable of addressing 65536 blocks. Since the disk is so large, 
this allows it to be broken up into more manageable pieces. YS dy 


The origin and size of the pseudo-disks on each drive are as follows: 


disk start length cylinder 

0 40600 0 thru 202 
40600 40600 203 thru 405 
0 9200 0 thru 45 
72000 9200 360 thru 405 
0 65535 O thru 327 
15600 65535 78 thru 405 
6-7 unassigned 


It is unwise for all of these files to be present in one installation, since there is overlap 
in addresses and protection becomes a sticky matter. Here is a suggestion for two use- 
ful configurations: If the root of the file system is on some other device and the RP 
used as a mounted device, then rp0 and rp/, which divide the disk into two equal size — 
portions, is a good idea. Other things being equal, it is advantageous to have two 
sr Naar portions since one can always be copied onto the other, which is occasion- 

ally useful . 


If the RP is the only disk and has to contain the root and the swap area, the root can 
be put on rp2 and a mountable file system on rp5. Then the swap space can be put in 
the unused blocks 9200 to 15600 of rp0 (or, equivalently, rp4). This arrangement puts 
the root file system, the swap area, and the i-list of the mounted file system relatively 
near each other and thus tends to minimize head movement. 


The rp files access the disk via the system’s normal buffering mechanism and may be 
ee read and written without regard to physical disk records. There is also a ‘‘raw’’ inter- 
face which provides for direct transmission between the disk and the user’s read or 
write buffer. A single read or write call results in exactly one I/O operation and there- 
fore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RP files begin with rrp and end with a number which selects the 
same disk section as the corresponding rp file. 


In raw I/O the buffer must begin on a word boundary, and counts should be a multi- 
ple of 512 bytes (a disk block). Likewise seek calls should specify a multiple of 512 
bytes. 


Un B&WN © 


FILES 
/dev/rp?, /dev/rrp? 


BUGS 


Bell Telephone Laboratories, Incorporated -l- | PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section 4 
Issue 1, January 1976 

AT&TCo SPCS 


TTY (IV) TTY (IV) 
NAME 
tty — general typewriter interface 
DESCRIPTION 
This section describes both a particular special file, and the general nature of the typewriter in- 
terface. 


All typewriters on the low-speed asynchronous communications ports use the same general in- 
terface, no matter what hardware is involved. The remainder of this section discusses the com- 
mon features of the interface; the k/, dc, and dh writeups (IV) describe peculiarities of the indi- 
vidual devices. 


When a typewriter file is opened, it causes the process to wait until a connection is established. 
In practice user’s programs seldom open these files; they are opened by init and become a 
user’s input and output file. The very first typewriter file open in a process becomes the conitrol 
typewriter for that process. The control typewriter plays a special role in handling quit or inter- 
rupt signals, as discussed below. The control typewriter is inherited by a child process during a 
Sork. 


A terminal associated with one of these files ordinarily operates in full-duplex mode. Charac- 
ters may be typed at any time, even while output is occurring, and are only lost when the 
system’s character input buffers become completely choked, which is rare, or when the user has 
accumulated the maximum allowed number of input characters which have not yet been read 
by some program. Currently this limit is 256 characters. When the input limit is reached all 
the saved characters are thrown away without notice. 


When first opened, the interface mode is 300 baud, either parity accepted, 10 bits/character 
(one stop bit), and newline action character. The system delays transmission after sending cer- 
tain function characters. Delays for horizontal tab, newline, and form feed are calculated for 
the Teletype Model 37; the delay for carriage return is calculated for the GE TermiNet 300. 
Most of these operating states can be changed by using the system call srry (II). In particular, 
provided the hardware permits, the speed of received and transmitted characters can be 
changed. In addition, the following software modes can be invoked: acceptance of even parity, 
odd parity, or both; a raw mode in which all characters may be read one at a time; a carriage re- 
turn (CR) mode in which CR is mapped into newline on input and either CR or line feed (LF) 
cause echoing of the sequence LF-CR; mapping of upper case letters into lower case; suppres- 
sion of echoing; suppression of delays after function characters; and the printing of tabs as 
spaces. See getty (VIII) for the way that terminal speed and type are detected. 


Normally, typewriter input is processed in units of lines. This means that a program attempting 
to read will be suspended until an entire line has been typed. Also, no matter how many char- 
acters are requested in the read call, at most one line will be returned. It is not however neces- 
sary to read a whole line at once; any number of characters may be requested in a read, even 
one, without losing information. 


During input, erase and kill processing is normally done. The character ‘#° erases the last char- 
acter typed, except that it will not erase beyond the beginning of a line or an EOT. The charac- 
ter ‘@’ kills the entire line up to the point where it was typed, but not beyond an EOT. Both 
these characters operate on a keystroke basis independently of any backspacing or tabbing that 
may have been done. Either ‘@’ or ‘#’ may be entered literally by preceding it by ‘\’; the erase 
or kill character remains, but the ‘\’ disappears. 7 


In upper-case mode, all upper-case letters are mapped into the corresponding lower-case letter. 
The upper-case letter may be generated by preceding it by ‘\’. In addition, the following escape 
sequences are generated on output and accepted on input: 
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for use 
: \ 
| \! 
\" 
{ \( 
} \) 


In raw mode, the program reading is awakened on each character. No erase or kill processing is 
done; and the EOT, quit and interrupt characters are not treated specially. The input parity bit 
is passed back to the reader, but parity is still generated for output characters. 


The ASCII EOT (control-D) character may be used to generate an end of file from a typewriter. 


_ When an EOT is received, all the characters waiting to be read are immediately passed to the 


program, without waiting for a new-line, and the EOT is discarded. Thus if there are no charac- 
ters waiting, which is to say the EOT occurred at the beginning of a line, zero characters will be 
passed back, and this is the standard end-of-file indication. The EOT is passed back unchanged 
in raw mode. 


When the carrier signal from the dataset drops (usually because the user has hung up his termi- 
nal) a hangup signal is sent to all processes with the typewriter as control typewriter. Unless 
other arrangements have been made, this signal causes the processes to terminate. If the hang- 
up signal is ignored, any read returns with an end-of-file indication. Thus programs which read 
a typewriter and test for end-of-file on their input can terminate appropriately when hung up 
on. 


Two characters have a special meaning when typed. The ASCII DEL character (sometimes 
called ‘rubout’) is nut passed to a program but generates an interrupt signal which is sent to all 
processes with the associated control typewriter. Normally each such process is forced to ter- 


. minate, but arrangements may be made either to ignore the signal or to receive a trap to an 


agreed-upon location. See signal (EI). 


The ASCII character FS generates the quit signal. Its treatment is identical to the interrupt sig- 
nal except that unless a receiving process has made other arrangements it will not only be ter- 
minated but a core image file will be generated. If you find it hard to type this character, try 
control-\ or control-shift-L.. | 


When one or more characters are written, they are actually transmitted to the terminal as soon 
as previously-written characters have finished typing. Input characters are echoed by putting 
them in the output queue as they arrive. When a process produces characters more rapidly 
than they can be typed, it will be suspended when its output queue exceeds some limit. When 
the queue has drained down to some threshold the program is resumed. Even parity is always 
generated on output. The EOT character is not transmitted (except in raw mode) to prevent 
terminals which respond to it from hanging up. 


FILES 

/dev/tty 
SEE ALSO 

de (IV), kl (lv), dh (IV), getty (VIII), stty (1, ID), gtty (II), signal (ID 
BUGS oe 


Half-duplex terminals are not supported. On raw- -mode output, parity should be transmitted as 
specified in the characters written. 
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~ NAME 
tc — TC-11/TUS6 DECtape 


DESCRIPTION 
The files tap0, ..., tap7 refer to the TC-11/TU56 DECtape drives 0 to 7. 


The 256-word blocks on a standard DECtape are numbered 0 to 577. 


FILES | 
/dev/tap? 


SEE ALSO | 
tp (I) 


BUGS. 
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TM (IV) TM (IV) 


NAME 


tm — TM-11/TU-10 magtape interface 


4 A 


DESCRIPTION 


FILES 


The files mz0, ..., mt7 refer to the DEC TU10/TM11 magtape. When one of mro, ..., 
mt3 is closed, the tape is rewound; if it was open for writing, a double end-of-file is 
written first. Conversely, when one of mt4, ..., mt7 is closed, the tape is not rewound; 
a single end-of-file is written if the tape was open for writing. By judiciously choosing 
mt files, it is possible to read and write multi-file tapes. 


A standard tape consists of a series of 512-byte records terminated by an end-of-file. 
To the extent possible (even though it is inefficient), the system allows the tape to be 
treated like any other file. Seeks have their usual meaning and it is possible to read or 
write a byte at a time. 


The mt files discussed above are useful when it is desired to access the tape in a way 
compatible with ordinary files. When foreign tapes are to be dealt with, and especially 
when long records are to be read or written, the ‘“‘raw’’ interface is appropriate. The 


- associated files are named rmt0, ...,. rmt7. Each read or write call reads or writes the 


next record on the tape. In the write case the record has the same length as the buffer 
given. During a read, the record size is passed back as the number of bytes read, pro- 
vided it is no greater than the buffer size; if the record is long, an error is indicated. 
In raw tape I/O, the buffer must begin on a word boundary and the count must be 
even. Seeks are ignored. An error is returned when a tape mark is read, but another 
read will fetch the first record of the new tape file. 


/dev/mt?, /dev/rmt? 


SEE ALSO 


BUGS 


tp (1), mtm (1) 


If any non-data error is encountered. it refuses to do anything more until closed. 
With the above mapping there is no way of getting to physical drives 4 to 7. 


V Fite Formats 
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NAME 
a.out — assembler and link editor output 


DESCRIPTION 
A.out is the output file of the assembler as and the link editor /d. Both programs make a.our 
executable if there were no errors and no unresolved external references. 


This file has four sections: a header, the program and data text, relocation bits and symbol table 
(in that order). The last two may be empty if the program was loaded with the ‘‘—s’’ option of 
ld or if the symbols and relocation have been removed by svrip. 


The header always contains 8 words: 


A magic number (407, 410, or 411(8)) 

The size of the program text segment 

The size of the initialized portion of the data segment 

The size of the uninitialized (bss) portion of the data segment 
The size of the symbol table 

The entry location (always 0 at present) 

Unused , 

A flag indicating relocation bits have been suppressed 


CO ~] DH Nn & WW RO — 


The sizes of each segment are in bytes but are even. The size of the header is not included in 
any of the other sizes. 


When a file produced by the assembler or loader is loaded into core for execution, three logical 
segments are set up: thé text segment, the data segment (with uninitialized data, which starts 
off as all 0, following initialized), and a stack. The text segment begins at 0 in the core image, 
the header is not loaded. If the magic number (word 0) is 407, it indicates that the text seg- 
ment is not to be write-protected and shared, so the data segment is immediately contiguous 
with the text segment. If the magic number is 410, the data segment begins at the first 0 mod 
8K byte boundary following the text segment, and the text segment is not writable by the pro- 
gram; if other processes are executing the same file, they will share the text segment. If the 
magic number is 411, the text segment is again pure, write-protected, and shared, and, moreo- 
ver, instruction and data space are separated; the text and data segment both begin at location 
0. See the 11/45 handbook for restrictions which apply to this situation. 


The stack will occupy the highest possible locations in the core image: from 177776(8) and 
growing downwards. The stack is automatically extended as required. The data segment is only 
extended as requested by the break system call. 


The start of the text segment in the file is 20(8); the start of the data segment is 20+S, (the 
size of the text) the start of the relocation information is 20+S +S,, the start of the symbol 
table is 20+2(S,+S,) if the relocation information is present, 20+S +S, if not. 


The symbol table consists of 6-word entries. The first four words contain the ASCII name of 
the symbol, null-padded. The next word ts a flag indicating the type of symbol. The following 
values are possible: 


00 undefined symbol 

01 absolute symbol 

Q2 text segment symbol 

03 data segment symbol 

37 file name symbol (produced by Id) 
04 bss segment symbol 

40 undefined external (.globl) symbol 
41 absolute external symbol 

42 text segment external symbol 

43 data segment external symbol 

44 bss segment external symbol 
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Values other than those given above may occur if the user has defined some of his own instruc- 
tions. 3 


The last word of a symbol table entry contains the value of the symbol. 


If the symbol’s type is undefined external, and the value field is non-zero, the symbol is inter- 
preted by the loader /d as the name of a common region whose size is indicated by the value of 
the symbol. | 


The value of a word in the text or data portions which is not a reference to an undefined exter- 
nal symbol is exactly that value which will appear in core when the file is executed. If a word 
in the text or data portion involves a reference to an undefined external symbol, as indicated by 
the relocation bits for that word, then the value of the word as stored in the file is an offset 
from the associated external symbol. When the file is processed by the link editor and the 
external symbol becomes defined, the value of the symbol will be added into the word in the 
file. | 


If relocation information is present, it amounts to one word per word of program text or initial- 
ized data. There is no relocation information if the ‘‘suppress relocation’’ flag in the header is 
on. 


Bits 3-1 of a relocation word indicate the segment referred to by the text or data word associat- 
ed with the relocation word: | 


00 indicates the reference is absolute 

02 indicates the reference is to the text segment 

04 indicates the reference is to initialized data 

06 indicates the reference is to bss (uninitialized data) 

10 indicates the reference is to an undefined external symbol. 


Bit 0 of the relocation word indicates if on, that the reference is relative to the pc (e.g., ‘‘clr 
x’). if off that the reference is to the actual symbol (e.g., ‘‘clr *$x°’). | 


The remainder of the relocation word (bits 15-4) contains a symbol number in the case of 
external references, and is unused otherwise. The first symbol is numbered 0, the second 1, 
etc. 


SEE ALSO 
as (I), Id (I), strip (I), nm (I) 
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NAME 
ar — archive (library) file format 
DESCRIPTION 


The archive command ar is used to combine several files into one. Archives are used 
mainly as libraries to be searched by the link-editor /d. 


A file produced by ar has a magic number at the start, followed by the constituent 
files, each preceded by a file header. The magic number is 177545(8) (chosen because 
it is unlikely to occur anywhere else). The header of each file is 26 bytes long: 


0-13 file name, null padded on the right 
14-17 modification time of the file 

18 user ID of file owner 

19 group ID of file owner 

20-21 file mode 

22-25 file size 


Each file begins on a word boundary; a null byte is inserted between files if necessary. 
Nevertheless, the size given reflects the actual size of the file exclusive of padding. 


Notice there is no provision for empty areas in an archive file. 


SEE ALSO 
ar (I), Id (1) 


BUGS 
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NAME 
core — format of core image file 
DESCRIPTION 
UNIX writes out a core image of a terminated process when any of various errors ot- 
cur. See signal (11) for the list of reasons; the most common are memory violations, 
illegal instructions, bus errors, and user- “generated quit signals. The core image is 
called ‘‘core’’ and is written in the process’s working directory provided: it can ‘be, 
normal access controls apply). - 
The first 1024 bytes of the core image are a copy of the system’s per-user data for the 
process, including the registers as they were at the time of the fault. The remainder 
represents the actual contents of the user’s core area when the core image was written. 
If the text segment is write-protected and shared, it is not dumped; otherwise the en- 
tire address space is dumped. 
The format of the information in the first 1024 bytes is described by the user structure 
of the system. -The important information not detailed there is the locations of the re- 
gisters. Here are their offsets. The parenthesized numbers for the floating registers 
are used if the Hoaung: -point hardware is in single precision mode, as mola in the 
Status register. | | | | 
fpsr 0004 
fr0 0006 (0006) 
fri 0036 (0022) 
fr2 0046 (0026) 
fr3 0056 (0032) 
fr4 0016 (0012) 
fr5 0026 (0016) 
r0 1772 
rl 1766 
r2 1750 
r3 1752 
r4 1754 
r5 1756 
sp 1764 
pc 1774 
ps 1776 
In seiietall the debuggers db (1) and cdb (I) are sufficient to deal with core images. 
SEE ALSO 


cdb (1), db (1), signal (ID 
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NAME . 
dir — format of directories 


DESCRIPTION 
A directory behaves exactly like an ordinary file, save that no user may write into a 
directory. The fact that a file is a directory is indicated by a bit in the flag word of its 
i-node entry. Directory entries are 16 bytes long. The first word is the i-number of 
the file represented by the entry, if non-zero; if zero, the entry is empty. 


Bytes 2-15 represent the (14-character) file name, null padded on the right. These 
bytes are not cleared for empty slots. 


By convention, the first two entries in each directory are for ‘‘.’’ and ‘‘..’’. The first is 
an entry for the directory itself. The second is for the parent directory. The meaning 
of ‘‘..”’ is modified for the root directory of the master file system and for the root 
directories of removable file systems. In the first case, there is no parent, and in the 
second, the system does not permit off-device references. Therefore in both cases 
‘*..”” has the same meaning as “‘.”’. 


SEE ALSO 
file system (V) 
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NAME 
dump — incremental dump tape format 


DESCRIPTION 
| The dump and restor commands are used to write and read incremental dump magnetic 


tapes. 
The dump tape consists of blocks of 512-bytes each. The first block has the following 
structure. | 


struct { | 
int 1SiZe; 

int fsize: 

int  date(2]. 

int _ ddate([2: 

| int — tsize; 

Isize, and fsize are the corresponding values ots the super block of the dumped file 
system. (See file system (V).) Date is the date of the dump. Ddate is the incremental 
dump date. The incremental dump contains all files modified between ddate and date. 
a i the number of blocks per reel. This block checksums to the octal value 


Next there are enough whole tape blocks to contain one word per file of the dumped 
file system. This is isize divided by 16 rounded to the next higher integer. The first 
word corresponds to i-node 1, the second to i-node 2, and so forth. If a word is zero, 
then the corresponding file exists, but was not dumped (was not modified after ddate). 
If the word is —1, the file does not exist. Other values for the word indicate that the 
file was dumped and the value is one more than the number of blocks it contains. 


The rest of the tape contains for each dumped file a header biock and the data biocks 
from the file. The header contains an exact copy of the i-node (see file system (V)) 
and also checksums to 031415. The next-to-last word of the block contains the tape 
block number, to aid in (unimplemented) recovery after tape errors. The number of 
data blocks per file is directly specified by the control word for the file and indirectly 
specified by the size in the i-node. If these numbers differ, the file was dumped with a 
‘phase error’. 


SEE ALSO 
dump (VIII), restor (VIII), file system (V) 
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NARIE 
fs — format of file system volume 


DESCRIPTION 
Every file system storage volume (e.g. RF disk, RK disk, RP disk, DECtape reel) has a com- 
mon format for certain vital information. Every such volume is divided into a certain number 
of 256-word (512 byte) blocks. Block 0 is unused and is available to contain a bootstrap pro- 
gram, pack label, or other information. 


Block | is the super block, Starting from its first word, the format of a super-block is 


struct | 
int isize; 
int fsize; 
int nfree; 
int free[100): 
int ninode; 


int inode[{f00): 

char flock; 

char ilock; 

char fmod; 

int time(2], 
i 
lsize is the number of blocks devoted to the i-list, which starts just after the super-block, in 
block 2. /size is the first block not potentially available for allocation to a file. These numbers 
are used by the system to check for bad block numbers; if an ‘‘impossible’’ block number ts al- 
located from the free list or is freed, a diagnostic is written on the on-line console. Moreover, 
the free array is cleared, so as to prevent further allocation from a presumably corrupted free 
list. 


The free list for each volume is maintained as follows. The /ree array contains, in freef//. ... , 
treelufree—1/, up to 99 numbers of free blocks. Free/0/ is the block number of the head of a 
chain of blocks constituting the free list. The first word in each free-chain block is the number 
(up to 100) of free-block numbers listed in the next 100 words of this chain member. The first 
of these 100 blocks is the link to the next member of the chain. To allocate a block: decrement 

~ nfree, and the new block is free/nfree/. If the new block number is 0, there are no blocks left. 
so give an error. If /ree became 0, read in the block named by the new block number, replace 
nfree by its first word, and copy the block numbers in the next 100 words into the free array. 
To free a block, check if free is 100; if so, copy free and the free array into it, write it out, and 
set wf/ree to 0. In any event set /ree/nfree/ to the freed block’s number and increment n/ree. 


Ninode is the number of free i-numbers in the :ode array. To allocate an i-node: if amode ts 
greater than 0, decrement it and return inode/ninode/. If it was 0, read the i-list and place the 
numbers of all free inodes (up to 100) into the mode array, then try egain. To free an i-node, 
provided awinode is less than 100, place its number into mode/nimode/] and increment minode. HW 
mnode is already 100, don’t bother to enter the freed i-node into any table. This list of i-nodes 
is only to speed up the allocation process; the information as to whether the inode is really free 
or not is maintained in the inode itself. 


Flock and ilock are flags maintained in the core copy of the file system while it is mounted and 
their values on disk are immaterial. The value of /mod on disk is likewise immaterial; it is used 
as a flag to indicate that the super-block has changed and should be copied to the disk during 
the next periodic update of file system information. 


Zine is the last time the super-block of the file system was changed, and is a double-precision 
representation of the number of seconds that have elapsed since 0000 Jan. 1 1970 (GMT). 
During a reboot, the mime of the super-block for the root file system is used to set the system's 
idea of the time. | 
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I-numbers begin at |, and the storage for i-nodes begins in block 2. Also, i-nodes are 32 bytes 
long, so 16 of them fit into a block. Therefore, i-node / is located in block (/ + 31) / 16, and 
begins 32°((1 + 31) (mod 16)) bytes from its start. I-node 1 is reserved for the root directory 
of the file system, but no other i-number has a built-in meaning. Each i-node represents one 
file. The format of an i-node is as follows; 


struct [ 
int flags; /* +0: see below */ 
char __ nlinks; /* +2: number of links to file */ 
char uid; /* +3: user ID of owner */ 
char __ gid; /* +4: group ID of owner */ 
char _ size0, /* +5: high byte of 24-bit size */ 
int sizel; /* +6: low word of 24-bit size */. 
int addr[8}: /* +8: block numbers or device number */ 
int actime[2]; /* +24: time of last access */ 
int modtime [2]; /* +28: time of last modification */ 


}, 
The flags are as follows: 


100000 _ i-node is allocated 
060000 2-bit file type: 
000000 i pilain file 
040000 _—_ directory 
020000 _ character-type special file 
060000 _ block-type special file. 
010000 large file 
004000 _ set user-ID on execution 
002000 set group-ID on execution 
000400 _—s read (owner) 
000200. write (owner) 
000100 execute (owner) 
000070 read, write, execute (group) 
000007 ~—sread, write, execute (others) 


Special files are recognized by their flags and not by i-number. A block-type special file is basi- 
cally one which can potentially be mounted as a file system; a character-type special file cannot, 
though it is not necessarily character-oriented. For special files the high byte of the first ad- 
dress word specifies the type of device; the low byte specifies one of several devices of that 
type. The device type numbers of block and character special files overlap. 


The address words of ordinary files and directories contain the numbers of the blocks in the file 
(if it is small) or the numbers of indirect blocks (if the file is large). Byte number ~ of a file is 
accessed as follows: # is divided by 512 to find its logical block number (say b ) in the file. If 
the file is small (flag 010000 is 0), then 5 must be less than 8, and the physical blcck number is 
addrlb]. 


If the file is large, 6 is divided by 256 to yield ¢. If sis less than 7, then addr[i] is the physical 
block number of the indirect block. The remainder from the division yields the word in the in- 
direct block which contains the number of the block for the sought-for byte. | 


For block 5 in a file to exist, it is not necessary that all blocks less than 5 exist. A zero block 
number either in the address words of the i-node or in an indirect block indicates that the 
corresponding block has never been allocated. Such a missing block reads as if it contained all 
zero words. 


SEE ALSO. _ 
icheck (VIII), check (VIID 
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NAME 
passwd — password file 


DESCRIPTION 
Passwd contains for each user the following information: 


name (login name, contains no upper case) 

encrypted password 

numerical user ID 

numerical group ID (for now, always 1) 

GCOS job number, box number, optional GCOS user-id 
initial working directory 

program to use as Shell 


This is an ASCII file. Each field within each user’s entry is separated from the next by a colon. 
The GCOS field is used only when communicating with that system, and in other installations 
can contain any desired information. Each user is separated from the next by a new-line. If the 
password field is null, no password is demanded; if the Shell field is null, the Shell itself is 
used. 


This file resides in directory /etc. Because of the encrypted passwords, it can and does have 
general read permission and can be used, for example, to map numerical user ID’s to names. 


FILES 
/etc/passwd 


SEE ALSO 
login (1), crypt (III), passwd (I) 
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NAME 
tp — DEC/mag tape formats 


DESCRIPTION | 
The command /¢p dumps files to and extracts files from DECtape and magtape. The 
formats of these tapes are the same except that magtapes have larger directories. 


ea zero contains a copy of a stand-alone bootstrap program. See boot procedures 
VIII). 


Blocks 1 through 24 for DECtape (1 through 62 for magtape) contain a directory of 
the tape. There are 192 (resp. 496) entries in the directory; 8 entries per block; 64 
bytes per entry. Each entry has the following format: 


path name 32 bytes 
mode 2 bytes 
uid 1 byte 
gid 1 byte 
unused 1 byte 
size 3 bytes 
time modified 4 bytes 
tape address 2 bytes 
unused 16 bytes 
check sum 2 bytes 


The path name entry is the path name of the file when put on the tape. If the path- 
name Starts with a zero word, the entry is empty. It is at most 32 bytes long and ends 
in a null byte. Mode, uid, gid, size and time modified are the same as described 
under i-nodes (file system (V)). The tape address is the tape block number of the 
start of the contents of the file. Every file starts on a block boundary. The file occu- 
pies (size+511)/512 blocks of continuous tape. The checksum entry has a value such 
that the sum of the 32 words of the directory entry is zero. 


Blocks 25 (resp. 63) on are available for file storage. 
A fake entry (see tp (I)) has a size of zero. 


SEE ALSO 
file system (V), tp (I) 
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NAME 
ttys — typewriter initialization data 


DESCRIPTION 
The ftys file is read by the init program and specifies which typewriter special files are 
to have a process created for them which will allow people to log in. It consists of 
lines of 3 characters each. 


The first character is either ‘0’ or ‘1’; the former causes the line to be ignored, the 
latter causes it to be effective. The second character is the last character in the name 
of a typewriter; e.g., x refers to the file ‘/dev/ttyx’. The third character is used as an 
argument to the getty program, which performs such tasks as baud-rate recognition, 
reading the login name, and calling /ogin. For normal lines, the character is ‘0’; other 
characters can be used, for example, with hard-wired terminals where speed recogni- 
tion is unnecessary or which have special characteristics. (Getty will have to be fixed in 
such cases.) 


FILES 
/etc/ttys 


SEE ALSO 
init (VIII), getty (VIII), login (1) 
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NAME 
utmp — user information 


DESCRIPTION | | | 
This file allows one to discover information about who is currently using: UNIX. The 
_ file is binary; each entry is 16(10) bytes long. The first eight bytes contain a user’s lo- 
gin name or are null if the table slot is unused. The low order byte of the next word 
contains the last character of a typewriter name. The next two words contain the 
user’s login time. The last word is unused. 


FILES 
/tmp/utmp 


SEE ALSO | | | 
init CVIID) and login (I), which maintain the file; who (I), which interprets it. 
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NAME : 
wimp — user login history 


DESCRIPTION 
This file records all logins and logouts. Its format is exactly like utmp (V) except that 
a null user name indicates a logout on the associated typewriter. Furthermore, the 
typewriter name ‘“’ indicates that the system was rebooted at the indicated time; the 
adjacent pair of entries with typewriter names ‘) and ‘}’ indicate the system-maintained 
time just before and just after a date command has changed the systern’s idea of the 
time. 


Wimp is maintained by /ogin (1) and init (VIII). Neither of these programs creates the 
file, so if it is removed, record-keeping is turned off. It is summarized by ac (VII. 


FILES 
/usr/adm/wtmp 


SEE ALSO 
utmp (V), login (1), init (VIII), ac (VID, who (1) 


VI User PROGRAMS 
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NAME 
agen — generate associative memory drivers 
SYNOPSIS 
agen file 
DESCRIPTION 


Agen permits easy referencing of table lookups, etc. 


The input consists of a series of table definitions followed by %% followed by pro- 
grams. Each definition is of the form 


name (accessing ) object ; 


where name is the name of a table to be searched; accessing is a description of the 
subscripts used, being a list of the choices ‘string’, ‘int’ and ‘char’. Object is an exam- 
ple of the things in the table. It is used only to get the size in bytes; it may be re- 
placed by the number corresponding to sizeof(object). Alternatively one of the access- 
ing arguments may be ‘size’ indicating that the number of bytes required will be given 
as that argument. The ‘exist’ argument may be given; if it is, the corresponding argu- 
ment of the search function is 0 for normal operation and 1 if failure to find the item 
should return 0 rather than a pointer to new storage for it. An ‘exist’ argument of -1 
implies that the corresponding object should be deleted. Also, an argument of ‘size’ 
may be given; this indicates that the size of the object to be stored will be supplied in 
the call (in bytes). 


It is also possible to specify a table size and a method. 

name [length] ["hash" | "binary"] (accessing) object ; 
specifies either a hash table or a binary tree search. For a hash search the length must 
be given. | 


BUGS 
The lookup routines are slow. 
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NAME 
bj — the game of black jack 
SYNOPSIS 
7 /usr/games/bj 


DESCRIPTION 


BUGS 


Bj is a serious attempt at simulating the dealer in the game of black jack (or twenty- 
one) as might be found in Reno. The following rules apply: 


The bet is $2 every hand. 


A player ‘natural’ (black jack) pays $3. A dealer natural loses $2. Both dealer 
and player naturals is a ‘push’ (no money exchange). 


If the dealer has an ace up, the player is allowed to make an ‘insurance’ bet 
against the chance of a dealer natural. If this bet is not taken, play resumes as 
normal. If the bet is taken, it is a side bet where the player wins $2 if the dealer 
has a natural and loses $1 if the dealer does not. 


If the player is dealt two cards of the same value, he is allowed to ‘double’. He 
is allowed to play two hands, each with one of these cards. (The bet is doubled 
also; $2 on each hand.) 


If a dealt hand has a total of ten or eleven, the player may ‘double down’. He 
may double the bet ($2 to $4) and receive exactly One more card on that hand. 


Under normal play, the player may ‘hit’ (draw a card) as long as his total is not 
over twenty-one. If the player ‘busts’ (goes over twenty-one), the dealer wins 
the bet. | 


When the player ‘stands’ (decides not to hit), the dealer hits until he attains a 
total of seventeen or more. If the dealer busts, the player wins the bet. 


If both player and dealer stand, the one with the largest total wins. A tie Is a 
push. 


The machine deals and keeps score. The following questions will be scree at appropri- 
ate times. Each question is answered by y followed by a new line for ‘yes’, or just 
new line for ‘no’. 


? (means, ‘‘do you want a hit?’’) 
Insurance? 
Double down? 


Every time the deck is shuffled, the dealer so states and the ‘action’ (total bet) and 
‘standing’ (total won or lost) is printed. To exit, hit the interrupt key (DEL) and the 
action and standing wi!l be printed. 
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NAME 
cal — print calendar 


SYNOPSIS 
cal [ month ] year 


DESCRIPTION 
Cal prints a calendar for the specified year. If a month is also specified, a calendar just 
for that month is printed. Year can be between 1 and 9999. The month is a number 
between 1 and 12. The calendar produced is that for England and her colonies. 


Try September 1752. 


BUGS 
The year is always considered to start in January even though this is historically naive. 
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NAME 
chess — the game of chess 
SYNOPSIS 
/usr/games/chess 


DESCRIPTION 
- Chess is a computer program that plays class D chess. Moves may be given either in 
standard (descriptive) notation or in algebraic notation. The symbol ‘+’ is used to 
specify check: ‘o-o’ and ‘o-o-o’ specify castling. To play black, type ‘first’; to print the 
board, type an empty line. | 


Each move is echoed in the appropriate notation followed by the program’s reply. 


FILES 
/usr/lib/book opening ‘book’ 

DIAGNOSTICS . . 
The most cryptic diagnostic is ‘eh?’ which means that the input was syntactically in- 
correct. 

WARNING 


Over-use of this program will cause it to go away. 


BUGS | 
Pawns may be promoted only to queens. 
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NAME 
cubic — three dimensional tic-tac-toe 
SYNOPSIS 
/usr/games/cubic 
DESCRIPTION 


Cubic plays the game of three dimensional 4x44 tic-tac-toe. Moves are given by the — 
three digits (each 1-4) specifying the coordinate of the square to be played. 


WARNING 
Too much playing of the game will cause it to disappear. 


BUGS 


~ Bell Telephone Laboratories, Incorporated -l- | : PA-1C3Q0-01 
PROGRAM APPLICATION INSTRUCTION | Section 6 
Issue 1, January 1976 

AT&TCo SPCS 


FACTOR (VI) FACTOR (VI) 


NAME 
factor — discover prime factors of a number 


SYNOPSIS 
factor 


DESCRIPTION 

When factor is invoked without an argument, it waits for a number to be typed in. If 
you type in a positive number less than 2°° (about 7.2x10'°) it will factor the number 
and print its prime factors; each one is printed the proper number of times. Then it 


waits for another number. It exits if it encounters a zero or any non-numeric charac- 
ter. | | —— 


If factor is invoked with an argument, it factors the number as above and then exits.. 


Maximum time to factor is proportional to ./n and occurs when n iS prime or the 
square of a prime. It takes 1 minute to factor a prime near 10°. 


DIAGNOSTICS 
‘Ouch.’ for input out of range or for garbage input. 


BUGS 


Bell Telephone Laboratories, Incorporated -l- PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION | Section 6 


Issue 1, January 1976 
AT&TCo SPCS 


FED (VI) FED (VI) 


NAME 


fed — edit form letter memory 


SYNOPSIS 


fed 


DESCRIPTION 


Fed is used to edit a form letter associative memory file, form.m, which consists of 
named strings. Commands consist of single letters followed by a list of string names 
Separated by a single space and ending with a new line. The conventions of the Shell 
with respect to ‘*’ and ‘?’ hold for all commands but m. The commands are: 


e name ... 
writes the string whose name is name onto a temporary file and executes ed. On 
exit from the ed the temporary file is copied back into the associative memory. 
Each argument is operated on separately. Be sure to give an editor w command 
(without a filename) to rewrite fed’s temporary file before quitting out of ed. 


d [name ... ] 
deletes a string and its name from the memory. When called with no arguments d 
operates in a verbose mode typing each string name and deleting only if a y is 
typed. A q response returns to feds command level. Any other response does 
nothing. 


m namel name? ... 7 
(move) changes the name of namel to name2 and removes previous string name2 
if one exists. Several pairs of arguments may be given. Literal strings are expected 
for the names. 


n [ name ... ] 
(names) lists the string names in the memory. If called with the optional argu- 
ments, it just lists those requested. 


p name ... 
prints the contents of the strings with names given by the arguments. 


q 
returns to the system. 


c[p][f] 
checks the associative memory file for consistency and reports the number of free 
headers and blocks. The optional arguments do the following: 
p causes any unaccounted-for string to be printed. 


f fixes broken memories by adding unaccounted-for headers to free storage and 
removing references to released headers from associative memory. 


FILES 
/tmp/ftmp? temporary 
| form.m associative memory 
SEE ALSO | 
form (VI), ed (I), sh (1) 
WARNING 


BUGS 


It is legal but unwise to have string names with blanks, ‘*’ or ‘?’ in them. 
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NAME 


form — form letter generator 


SYNOPSIS 


form proto arg ... 


By een 


Form generates a form letter from a prototype letter, an associative memory, arguments and in 
a special case, the current date. 


If form is invoked with the profo argument x, the associative memory is searched for an entry 
with name x and the contents filed under that name are used as the prototype. If the search 
fails, the message ‘[x]:’ is typed on the console and whatever text is typed in from the console, 
terminated by two new lines, is used as the prototype. If the prototype argument is missing, 
‘{letter}’ is assumed. 


Basically, form is a copy process from the prototype to the output file. If an element of the 
form [n] (where 7 is a digit from 1 to 9) is encountered, the n-th arg is inserted in its place, 
and that argument is then rescanned. If [0] is encountered, the current date is inserted. If the 
desired argument has not been given, a message of the form ‘[n]:’ is typed. The response typed 
in then is used for that argument. 


If an element of the form [name] or {name} is encountered, the name is looked up in the associ- 
ative memory. If it is found, the contents of the memory under this name replaces the original 
element (again rescanned). If the name is not found, a message of the form ‘[name]:’ is typed. 
The response typed in is used for that element. The response is entered in the memory under 
the name if the name is enclosed in [ ]. The response is not entered in the memory but is 
remembered for the duration of the letter if the name is enclosed in {}. Brackets and braces 
may be nested. 


In both of the above cases, the response is typed in by entering arbitrary text terminated by two 
new lines. Only the first of the two new lines is passed with the text. 


If one of the special characters [{]}\ is preceded by a \, it loses its special character. 


If a file named ‘forma’ already exists in the user’s directory, ‘formb’ is used as the output file 
and so forth to ‘formz’. 


The file ‘form.m’ is created if none exists. Because form.m is operated on by the disc allocator, 
it should only be changed by using fed, the form letter editor, or form. 


FILES 
form.m | associative memory 
form? output file (read only) 
SEE ALSO 
fed (VI), nroff (I) 
BUGS 


An unbalanced } or } acts as an end of file but may add a few strange entries to the associative 
memory. | 
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NAME 
gsi — interpret extended character set on GSI terminal 


SYNOPSIS 
gsi 


DESCRIPTION | 
Gsi interprets special characters understood by the Model 37 Teletype terminal and turns them 
into the escape sequences understood by the GSI and other Diablo-based terminals. The things 
interpreted include vertical motions and extended graphic characters. It is most often used in a 
pipeline like 


nroff file ... | gsi 
SEE ALSO 


BUGS 
Some funny characters can’t be correctly printed in column 1 because you can’t move to the 
left from there. 
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NAME 
hyphen — find hyphenated words 
SYNOPSIS 
hyphen file ... 
DESCRIPTION ! 


It finds all of the words in a document which are hyphenated across lines and prints 
them back at you in a convenient format. 


If no arguments are given, the standard input is used. Thus hyphen may be used as a 
filter. 


BUGS 
Yes, it gets confused. but with no ill effects other than spurious extra output. 
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NAME 
lex — generate programs for simple lexical tasks 


SYNOPSIS 
lex [ -code | file 


DESCRIPTION 
Lex generates programs for simple lexical analysis. 


The input file contains strings and expressions to be searched for, and C text to be ex- 
ecuted when found. A file lex.yy.c is generated which, when loaded with the library, 
copies the input to the output except when a string specified in the file is found; then 
the corresponding program text is executed. The strings may contain square brackets 
to indicate character classes, as in 


[abx-z] 


to indicate a, b, x, y, and z; and the operators *, +, and ? mean respectively any non- 
negative number of, any positive number of, and either zero or one occurences of, the 
previous character or character class. The character ’.’ is the class of all ascii characters 
except newline. Parentheses for grouping and vertical bar for alternation are also sup- 
ported. The character ~ at the beginning of an expression permits a successful match 
only immediately after a newline, and the character $ at the end of an expression re- 
quires a trailing newline. The character / in an expression indicates trailing context; 
only the part of the expression up to the slash is returned in yylextext, but the 
remainder of the expression must follow in the input stream. An operator character 
may be used as an ordinary symbol if it is within " symbols or preceded by \. Thus 


{a-zA-Z]+ 


matches a string of letters. The actual string matched is left in yylextext, an external 
character array. Matching is done in order of the strings in the file. 


Three subroutines are expected: input() to read a character; unput(c) to replace a 
character read; and output(c) to place an output character. The library defines these in 
terms of the standard streams (and the -lp portable library), but you can replace them. 
The program generated is named yylex(), and the library contains a main() which calls 
it. The action REJECT on the right side of the rule causes this match to be rejected 
and the next suitable match executed: the function yymore() accumulates additional 
characters into the same yylextext; and the function yyless(p) pushes back the portion 
of the string matched beginning at p, which should be between yylextext and yylastch. 


Any line beginning with a blank is assumed to contain only C text and is copied; if it 
precedes %% it is copied into the external definition area of the lex.yy.c file. All rules 
should follow a %%, as in YACC. Lines preceding %% which begin with a non-blank 
define the string on the left to be the remainder of the line; it can be called out later 
by surrounding it with {}. Note that curly brackets do not imply parentheses; only 
String substitution is done. Example: 


D [0-9] 
%% 
if printf("IF statement\n"); 


[a-z]+ printf("tag, value %s\n",yylextext); 
0(D}+ printf("octal number %s\n",yylextext); 
{D}+  printf("decimal number %s\n",yylextext); 


in, printf("unary op\n"); 
ee printf("binary op\n"); 
nye loop: 


while (input != °*’); 
switch (input()) 


case ’/°: break; 
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case ***: unput(’*’); 
default: go to loop; 


The external names generated by lex all begin with the "code" string from the optional 
first argument, if omitted it is "yy". Furthermore,the name of the output file is 
"lex.code.c” in the general case. The code argument may be given on the first line of 
the input file as %-code. 


FILES 
/lib/libl.a (-1) library 


BUGS 


A right context portion of an expression (past a / ) may not contain the operators * 
+, ? lor (¢. 
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MOO (VI) MOO (VI) 


NAME 
moo — guessing game 
SYNOPSIS 
/usr/games/moo 
DESCRIPTION | 


Moo is a guessing game imported from England. The computer picks a number con- 

sisting of four distinct decimal digits. The player guesses four distinct digits being 
scored on each guess. A ‘cow’ is a correct digit in an incorrect position. A ‘bull’ is a 
correct digit in a correct position. The game continues until the player guesses the 
number (a score of four bulls). 


BUGS 
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NAME 
ptx — permuted index 


SYNOPSIS 
ptx [ —t ] input [ output ] 


DESCRIPTION oe 4. 
Pix generates a permuted index from file imput.on “file aiitpitd Tt has three phases: the 
first does the permutation, generating one line for each keyword in an input line. The 
keyword is rotated to the front. The permuted file is then sorted. Finally: the sorted 
lines are rotated so the keyword comes at the middle of the page. 
Input should be edited to remove useless lines. The following words are suppressed: 
‘a’, ‘an’, ‘and’, ‘as’, ‘is’, ‘for’, ‘of’, ‘on’, ‘or’, ‘the’, ‘to’, ‘up’, ‘all’, ‘at’, ‘data’, ‘do’, 
in’, ‘into’, ‘when’. 
The optional argument —t causes prx to prepare its output for the phototypesetter. 
The index for this manual was generated using pix. 


FILES 
/bin/sort 
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SNO (VI) SNO (VI) 


NAME 


sno — Snobol interpreter 


SYNOPSIS 


sno [ file ] 


DESCRIPTION 


Sno is a Snobol III (with slight differences) compiler and interpreter. Sno obtains input — 
from the concatenation of fi/e and the standard input. All input through a statement 
containing the label ‘end’ is considered program and is compiled. The rest is available 
to ‘syspit’. 

Sno differs from Snobol III in the following ways. 

There are no unanchored searches. To get the same effect: 


a**b unanchored search for b 
a *x* b = x c unanchored assignment 


There is no back referencing. 


x = "abc" 
a *x* x is an unanchored search for ‘abc’ 


Function declaration is different. The function declaration is done at compile time by 
the use of the label ‘define’. Thus there is no ability to define functions at run time 
and the use of the name ‘define’ is preempted. There is also no provision for au- 
tomatic variables other than the parameters. For example: 


define f() 

or 

define f(a,b,c) | 

All labels except ‘define’ (even ‘end’) must have a non-empty statement. 


If ‘start’ is a label in the program, program execution will start there. If not, execu- 
tion begins with the first executable statement. ‘define’ is not an executable state- 
ment. 


There are no built-in functions. 


Parentheses for arithmetic are not needed. Normal precedence applies. Because of 
this, the arithmetic operators ‘/’ and ‘*’ must be set off by space. 


The right side of assignments must be non-empty. 
Either ‘ or " may be used for literal quotes. 
The pseudo-variable ‘sysppt’ is not available. 


SEE ALSO 


' BUGS 


Snobol II] manual. (JACM; Vol. 11 No. 1; Jan 1964; pp 21) 
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TMAC (VI) | TMAC(VI)_ 


NAME 
tmac — macros for formatting manuscripts 


SYNOPSIS 
nroff —ms [ options ] file ... 


DESCRIPTION | 
This package of vroff macro definitions provides a canned formatting facility for technical pa- 
pers. When producing 2-column output on a terminal, its output should be filtered through co/ 


(I). 3 


The package supports three different formats: BTL technical memorandum with cover sheet, 
released paper with cover sheet, and an abbreviated ‘debugging’ form without cover sheet. 


The macro requests are defined in the attached Request Reference. Many nroffrequests are un- 
safe in conjunction with this package, however the requests listed below may be used with im- 
punity after the first .PP. 


.bp ‘begin new page 

.br break output line here 

Sp n insert n spacing lines 

isn (line spacing) n=1 single, n=2 double space 
na no alignment of right margin 


Output of the /d/ (I) preprocessor for tables is acceptable as input. 


FILES 
/usr/lib/tmac.s 


SEE ALSO 
nroff (1) 


BUGS 
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Request Initial 


Form Value 
AC yes 
2C no 
.AB no 
AE - 
Al no 
AU xy no 
.B no 
CS x - 
.DA x nroff 
.DE - 
DS x no 
.EN - 
.EQ x - 
FE - 
.FS no 
.HO - 

I no 
AP xy no 
.KKE - 
KF no 
.KS no 
.LG no 
.LP yes 
.MH - 
.NH n - 
NL yes 
OK - 
.PP no 
R yes 
RE - 
RP no 
RS - 
SG x no 
SH - 
SM no 
TL no 
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TMAC (VI) 
REQUEST REFERENCE 

Cause 

Break Explanation 

yes One column format on a new page. 

yes Two column format. 

yes Begin abstract. 

yes End abstract. 

yes Author’s institution follows. Suppressed in TM. 

yes Author’s name follows. x is location and y is extension, ignored except in TM. 

no Boldface text follows. 

yes Cover sheet info if TM format, suppressed otherwise. Arguments are number 
of text pages, other pages, total pages, figures, tables, references. 

no ‘Date line’ at bottom of page is x. Default is today. 

yes End displayed text. Implies .KE. 

yes Start of displayed text, to appear verbatim line-by-line. x=I for indented 
display (default), x=L for left-justified on the page, x=C for centered. Implies 
KS. 

yes Space after equation produced by egn or negqn. 

yes Space before equation. Equation number is x. 

yes End footnote. 

no Start footnote. The note will be moved to the bottom of the page. 

no ‘Bel! Laboratories, Holmdel, New Jersey 07733°. 

no Italic text follows. 

yes Start indented paragraph, with hanging tag x. Indentation is » ens (default 5). 

yes End keep. Put kept text on next page if not enough room. 

yes Start floating keep. If the kept text must be moved to the next page, float later 
text back to this page. 

yes Start keeping following text. 

no Make letters larger. 

yes Start left-blocked paragraph. 

no ‘Bell Laboratories, Murray Hill, New Jersey 07974’. 

yes Same as .SH, with section number supplied automatically. Numbers are mul- 
tilevel, like 1.2.3, where # tells what level is wanted (default is 1). 

no Make letters normal size. 

yes ‘Other keywords’ for TM cover sheet follow. 

yes Begin paragraph. First line indented. 

no Roman text follows. 

yes End relative indent level. 

- Cover sheet and first page for released paper. Must precede other requests. 

yes Start level of relative indentation. Following .IP’s measured from current in- 
dentation. 

yes Insert signature(s) of author(s), ignored except in TM. 1x is the reference line 
(initials of author and typist). 

yes Section head follows, font automatically bold. 

no Make letters smaller. 

yes Title follows. 


- BTL TM cover sheet and first page, x=TM number, »=(quoted list of) case 
number(s), z=file number. Must precede other requests. 
no ‘Bell Laboratories, Whippany, New Jersey 07981’. 
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NAME 
ttt — the game of tic-tac-toe 
SYNOPSIS 
/usr/games/ttt 


DESCRIPTION : a 
7 Ttt is the X and O game popular in the first grade. This is a learning program that 
never makes the same mistake twice. 


Although it learns, it learns slowly. It must lose nearly 80 games to know the game 
completely. 


FILES 
/usr/games/ttt.k learning file 


BUGS 
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NAME 
wump — the game of hunt-the-wumpus 
SYNOPSIS 
/usr/games/wump 
DESCRIPTION | 


Wump plays the game of ‘‘Hunt the Wumpus.’’ A Wumpus is a creature that lives in a 
cave with several rooms connected by tunnels. You wander among the rooms, trying 
to shoot the Wumpus with an arrow, meanwhile avoiding being eaten by the Wumpus 
and falling into Bottomless Pits. There are also Super Bats which are likely to pick you 
up and drop you in some random room. 


The program asks various questions which you answer one per line; it will give a more 
detailed description if you want. 


This program is based on one described in People’s Computer Company, 2, 2 (No- 
vember 1973). 


BUGS 
It will never replace Space War. 


VII TABLES 
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NAME 


ascii — map of ASCII character set 


SYNOPSIS 
cat /usr/pub/ascii 


DESCRIPTION 


PA-1C300-01 
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ASCII (VII) 


Ascii is a map of the ASCII character set, to be printed as needed. It contains: 


000 nul /001 soh|002 stx|003 etx/004 eot|005 enq|006 ack/007 be! 
010 bs {011 ht {012 nl 
020 dle|021 dcl}022 dc2|023 dc3}024 dc4)025 


013 


030 can|031 em {032 sub/ 033 
040 sp {041 ! {042 " 1043 
050 ( 1051 ) {052 * |053 
060 O {061 1 {062 2 |063 
070 8 {071 9 1072 : |073 
100 @|101 A s102 B {103 
110 Hi illi 1 4112 J 4113 
120 P {121 Q 4122 R {123 
130 X 4131 Y {132 Z {133 
140 141 a {142 b |143 
150 h {151 i {152 j {153 
160 p {161 q {162 r |163 
170 x {171 y |172 z 4173 


FILES 
found in /usr/pub 


vt {014 np {O15 
esc|034 fs {035 
# 1044 $ {045 
+ 1054 , {055 
3 1064 4 |06S 
- 1074 < 1075 
C 1104 D {105 
K }114 L {115 
S 1124 T {125 
[ 1134 \ ]|135 
c {144 d [145 
k 1154 1 {1155 
s |164 t |165 
{ |174 | }175 


—ce5S0-—-Cemi ui 


016 


so {017 si 


rs 


Re 


I< Bm OM ANVA: 


syn ne etb 


7 us 


= 
ae | 
SOQ-y~xa™ 
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GREEK (VII) © GREEK (VI) 
NAME 


greek — graphics for extended TTY-37 type-box 


SYNOPSIS 
cat /usr/pub/greek 


DESCRIPTION | , 
Greek gives the mapping from ascii to the ‘‘shift out’’ graphics in effect between SO 
and SI on model 37 Teletypes with a 128-character type-box. It contains: 


alpha a A beta B B gamma y \ 
GAMMA r G delta 5 D DELTA A W 
epsilon e § zeta ¢ Q eta 7 N 
THETA 6 T theta . 6 O lambda A L 
LAMBDA A E mu uw M nu. yp @ 
Xi é |X pl wr J [ Il P 
rho p kK sigma ao Y SIGMA x2 R 
tau ae | phi @ U PHI m F 
psi wy OV PSI wv H omega wo C 
OMEGA Q Z nabla | rn not — -— 
partial a] integral : (ie 

SEE ALSO 


ascii (VII) 
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MT AB (VII) MTAB (VIT) 


NAME 
mtab — mounted file system table 


DESCRIPTION . 
Miab resides in directory /etc and contains a table of devices mounted by the mount 
command. Umount removes entries. 


Each entry is 64 bytes long; the first 32 are the null-padded name of the place where 
the special file is mounted; the second 32 are the null-padded name of the special file. 
The special file has all its directories stripped away; that is, everything through the last 
‘7 is thrown away. 


This table is present only so people can look at it. It does not matter to mount if there 
are duplicated entries nor to wmount if a name cannot be found. | 


FILES 
/etc/mtab 


SEE ALSO | 
mount (VIII), umount (VIID 


BUGS 
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TABS (VII) TABS (VII) 
NAME 


tabs — set tab stops 


SYNOPSIS — St then 
cat /usr/pub/tabs 


DESCRIPTION — . 1 tee : 7 
Printing this file on a suitable terminal sets tab stops every 8 columns. Suitable termi- 
nals include the Teletype model 37 and the GE TermiNet 300. 


These tab stop settings are desirable because UNIX assumes them in calculating de- 
lays. . 4 | 


VIII System PRoGRAMS 
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AC (VIII) AC (VIIT) 


NAME 


ac — login accounting 


SYNOPSIS 


ac [ —w wtmp ] [ —p] [ —d_] people 


DESCRIPTION 


FILES 


Ac produces a printout giving connect time for each user who has logged in during the life of 
the current wimp file. A total is also produced. —w is used to specify an alternate wémp file. 
—p prints individual totals; without this option, only totals are printed. -d causes a printout 
for each midnight to midnight period. Any people after —p will limit the printout to only the 
specified login names. If no wimp file is given, /usr/adm/wtmp is used. 


The accounting file /usr/adm/wtmp is maintained by init and Jogin. Neither of these programs 
creates the file, so if it does not exist no connect-time accounting is done. To start accounting, 
it should be created with length 0. On the other hand, if the file is left undisturbed, it will grow 
without bound, so periodically any information desired should be collected and the file truncat- 
ed. 


/usr/adm/wtmp 


SEE ALSO 


BUGS 


init (VIII), login (I), wtmp (V). 
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TARE 


boot procedures - UNIX startup 


_ The. advent of the 11/70 and its associated peripherals has changed the boot pro- 
cedures. These procedures apply only to C-language systems. 


How to siart UNIX. UNIX is started by placing it in core starting at iecation zero and 
transferring to zero. There are various ways to do this. 


The ip command places a bootsirap programm on the otherwise unused block zero of 
the tape. The DECtape version of this boot program is called tboot, the magtape ver- 
sion mboot. If tboot or mboot is read into location zero and executed there, it will type 
==’ on the console, read in a tp entry name, load that entry into core, and transfer to 
zero. Thus one way to run UNIX is to maintain the UNIX code on a tape using ¢p. 
Caution: the file /usr/mdec/itboot (DECtape) or /usr/mdec/mboot (magtape) must be 
present when the tape is made or updated. Then when a boot is required, execute a 
program which reads in and jumps to the first block of the tape. The standard DEC 
ROM which loads DECtape is sufficient to read in ¢boot, but the magtape ROM loads 
block one, not zero. If no suitable ROM is available, magtape and DECtape programs 
are presented below which may be manually placed in core and executed. In response 
to the ‘=’ prompt, type the entry name of the system on the tape (we use plain 
‘unix’). It is strongly recommended that a current version of the system be main- 
tained in this way, even if another method of booting the system is usually used. 


Another method of booting the system involves the otherwise unused block zero of 
each UNIX file system. One of four separate boot programs can be used in this 
method. The single-block program uwboot reads a single character (either p or k for 
RPO3 or RK04/05, drive 0) to specify which device is to be searched. The other boot 
programs are called rkboot, rpbect, and hpboot. These programs are also one block long 
and they also read one character from the console, but they are designed to search one 
device type (drive zero in all cases), not one of two. Rkboor accepts the character k 
and searches the RK04/05 disk. Rpboot accepts the character p and searches the RP0O3 
disk. Apboot accepts the character 4 and searches the RP04 disk. All four bootstrap 
programs will then read a UNIX pathname from the console, find the corresponding 
file on the device, load that file into core location zero, and transfer to it. Uboot, 
rkboot, rpboot, and hpboot operate under very severe space constraints. They supply no 
prompts, except a carriage return and line feed that are echoed after the p, k, or 4. 
No diagnostic is provided if the indicated file cannot be found, nor is there any means 
of correcting typographical errors in the file name except to start the program over. 
These four bootstrap programs can reside in block zero of the device(s) they are capa- 
ble of searching, or they may be loaded from a ¢p tape as described above. The correct 
bootstrap program can be placed on block zero at system generation by the mk/fs (VII) | 
command or it can be placed there any time after that with the cp (I) command. 


The standard DEC disk ROMs will pee and execute uwboot, rkboot, rpboot, and hpboot 
from block zero of the device. 


The switches. The console switches play an important role in the use and especially 
the booting of UNIX. During operation, the console switches are examined 60 times 
per second, and the contents of the address specified by the switches are displayed in 
the data display register only if the data display select knob is set to display register. 
(This is not true on the 11/40 since there is no display register on that machine.) If 
the switch address is even, the address is interpreted in kernel (system) space; if odd, 
the rounded-down address 1s interpreted in the current user space. 


if any diagnostics are produced by the sysiem, they are printed on the console only if 
the switches are non-zero. Thus it is wise to have a non-zero value in the switches at 
all times. 


Bell Telephone Laboratories, Incorporated -2- PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section | 
Issue 1, January 1976 

AT&TCo SPCS 


BOOT PROCEDURES (VIII) BOOT PROCEDURES (VIII) 


During the startup of the system, the init program (VIII) reads the switches and will 
come up single-user if the switches are set to 773030 on an 11/40 or an 11/45 or if the 
switches are set to 1773030 on an 11/70. 


It is unwise to have a non-existent address in the switches. This causes a bus error in 
the system (displayed as 177777) at the rate of 60 times per second. If there is a 
transfer of more than 15ms duration on a device with a data rate faster than the bus 
error timeout (approx 10s), then a permanent disk non-existent-memory error will 
occur. 


ROM programs. Here are some programs which are suitable for installing in read-only 
memories, or for manual keying into core if no ROM is present. Each program is 
position-independent but should be placed well above location 0 so it will not be 
overwritten. Each reads a block from the beginning of a physical device into core loca- 
tion zero. The octal words constituting the program are listed on the left. 


DECtape (drive 0) from endzone: 


012700 mov $tcba,r0 

177346 

010040 mov r0,-(r0) / use tc addr for we 

012710 mov $3, (r0) / read bn forward 

000003 

105710 1: — tstb (r0) / wait for ready 

002376 bge lb 

112710 movb- $5,(r0) / read (forward) 

000005 

000777 br - / loop; now halt and start at 0 


DECtape (drive 0) with sea 
012700 1: mov $tcba,r0 


177346 

010040 MOV r0,-(r0) / use tc addr for we 
012740 mov $4003,-(r0) / read bn reverse 
004003 

005710 2: .tst (r0) 

002376 bge 2b / wait for error 
005760 tst -2(r0) / loop if not end zone 
177776 

002365 bge lb 

012710 mov —_ $3, (r0) / read bn forward 
000003 

105710 2: — tstb (r0) / wait for ready 
002376 bge 2b 

112710 movb  $5,(r0) / read (forward) 
000005 

105710 2: — tstb (r0) / wait for ready 
002376 bge 2b 

005007 clr pe / transfer to zero 


Caution: both sei these DECtape programs will (literally) blow a fuse if 2 drives are ai: 
aled to zero. 


Magtape (TU10) from load ne 


012700 mov $mtcma,r0 

172526 

010040 mov r0,-(r0) / usr mt addr for wc 
012740 mov $60003,-(r0) / read 9-track 
060003 | 


000777 br / loop; now halt and start at 0 
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Magtape (TU16) from load point: 


The numbers in parentheses are for an 11/70 


Zero the following addresses 

772442 (1772442) 

7172444 (1772444) 

7172446 (1772446) 
Halt and load address 772472 (1772472) 
Set switches to 001300 (0001300) 
Load address 772440 (1772440) 
Set switches to 000071 (0000071) 
Enable and deposit 


RK (drive 0): 


012700 mov $rkmr,r0 
177414 
005040 clr -(r0) 
005040 clr -(r0) 
010040 mov r0,-(r0) 
012740 mov _ $5,-(r0) 
000005 . 
1057101: tstb (r0) 
002376 bee Ib 
005007 cir pe 
RPO3 (drive 0) 
012700 mov $rpmr.r0 
176726 
005040 clr -(r0) 
005040 clr -(r0) 
005040 clr -(r0) | 
010040 mov r0,-(r0) 
012740 mov $5,-r0) 
000005 
105710 iI: tstb (r0) 
002376 bge lb 
005007 ~ elr pc 


RP0O4 (drive 0) 
The parentheses are for an 11/70 
Halt and load address 765000 yong: 
Set switches to 000070 (0000070) 
Enable and start 


FILES 
/usr/sys/unix — UNIX code 
/usr/mdec/mboot — tp magtape bootstrap 
/usr/mdec/tboot — tp DECtape bootstrap 
/usr/mdec/uboot — file system bootstrap 


/usr/mdec/tu/rkboot — RK04/05 file system bootstrap 
/usr/mdec/tu/rpboot — RPO3 file system bootstrap 
/usr/mdec/tu/hpboot — RP04 file system bootstrap 


SEE ALSO 
tp (I), init (VII), mkfs (VHD 
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NAME 
check — file system consistency check 


SYNOPSIS 
check [ —Isuib [ numbers } ] [ filesystem ] 


DESCRIPTION 
Check examines a file system, builds a bit map of used blocks, and compares this bit 
map against the free list maintained on the file system. It also compares the link- 
count for each allocated i-number (i.e., i-node) with the number of references (i.e., 
directory entries) to it. If the file system is not specified, a check of a default file sys- 
tem is performed. The normal output of check includes a report of 


the number of blocks missing (i.e., not 
in any file nor in the free list), 
the number of special files, 
the total number of files, 
the number of large files, 
the number of directories, 
the number of indirect blocks, 
the number of blocks used in files, 
the highest-numbered block appearing in a file, 
the number of free blocks. 


The —1 flag causes check to produce as part of its output report a list of all the path 
names of files on the file system. The list is in i-number order; the first name for 
each file gives the i-number while subsequent names (i.e., links) have the i-number 
suppressed. The entries *‘.’’ and **..’’ for directories are also suppressed. If the flag is 
given as —Il, the listing will include the accessed and modified times for each file. 
The —] option Supersedes --S. 


The —s flag causes check to ignore the actual free list and reconstruct a new one by 
rewriting the super-block of the file system. The file system should be dismounted 
while this is done; if this is not possible (for example, if the root file system has to be 
salvaged), care should be taken that the system is quiescent and that it is rebooted im- 
mediately afterwards so that the old, bad in-core copy of the super-block will not con- 
tinue to be used. However, a sync (VIII) prior to the reboot will undo the salvage. 
Notice also that the words in the super-block which indicate the size of the free list 
and of the i-list are believed. If the super-block has been curdled, these words will 
have to be patched. The -—s flag causes the normal output reports to be suppressed. 


With the --u flag, check examines the directory structure for connectivity. A list of all 
i-node numbers that cannot be reached from the root is printed. This is exactly the 
list of i-nodes that should be cleared (see c/ri (VIII)) after a series of incremental re- 
stores. (See the bugs section of restor (VII).) The —u option supersedes —s. 


The occurrence of i n times in a flag argument, ~il...i, causes check to store away the 
next ” arguments which are taken to be i-numbers. When any of these i-numbers is 
encountered in a directory, a diagnostic is produced, as described below, which indi- 
cates among other things the entry name. 


_ Likewise, appearances of b in a flag, like —bb...b, cause the next n arguments to be 
taken as block numbers which are remembered; whenever any of the named blocks 
turns up in a file, a diagnostic is produced. 


FILES 
Currently, /dev/rp0 is the default file system. 


SEE ALSO 
fs (V), a (VII), restor (VIID 
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DIAGNOSTICS 
If a read error is encountered, the block number of the bad block is printed and check 
exits. ‘‘Bad freeblock’’ means that a block number outside the available space was en- 
countered in the free list. ‘‘n dups in free’’ means that m blocks were found in the 
free list which duplicate blocks either in some file or in the earlier part of the free list. 


An important class of diagnostics is produced by a routine which is called for each 
block which is encountered in an i- -node corresponding to an ordinary file or directory. 
These have the form 


b# complaint ; i= i# (class ) 


Here 5# is the block number being considered; complaint is the diagnostic itself. It 
may be 


blk if the block number was mentioned as an argument after —b; 

bad if the block number has a value not inside the allocatable space on the device, 
as indicated by the devices’s super-block; 

dup if the block number has already been seen in a file; 

din if the block is a member of a directory, and if an entry is found therein whose 
i-number is outside the range of the i-list on the device, as indicated by the 
i-list size specified by the super-block. Unfortunately this diagnostic does not 
indicate the offending entry name, but since the i-number of the directory it- 
self is given (see below) the problem can be tracked down. 


The /# in the form abwve is the i-number in which the named block was found. The 
class is an indicator of what type of block was involved in the difficulty: 


sdir indicates that the block is a data block in a small file; 
Idir indicates that the block is a data block in a large file (the indirect block 
number is not available), 
idir 7 nae: that the block is an indirect block (pointing to data blocks) in a large 
le: 
free indicates that the block was mentioned after —b and is free; 
urk indicates a malfunction in check. 


When an i-number specified after —i is encountered while reading a directory, a report 
in the form 


# ino; i= d# (class ) name 


where /# is the requested i-number, d# is the i-number of the directory, c/ass is the 
class of the directory block as discussed above (virtually always ‘‘sdir’’) and name is 
the entry name. This diagnostic gives enough information to find a full path name for 
an i-number without using the -] option: use —b » to find an entry name and the i- 
number of the directory containing the reference to n, then recursively use —b on the 
i-number of the directory to find its name. 


Another important class of file system diseases indicated by «heck is files for which the 
number of directory entries does not agree with the link-couat field of the i-node. 
The diagnostic is hard to interpret. ‘It has the form 


i# delta 


Here i‘# is the i-number affected. ‘Delra is an octal number accumulated in a byte, and 
thus can have the value 0 through 377(8). The easiest way (short of rewriting the 
routine) of explaining the significance of /e/ta is to describe how it is computed. 


If the associated i-node 1s allocated (that is, has the a/located bit on), add 100 to delta. 
If its link-count is non-zero, add another 100 plus the link-count. Each time a directo- 
ry entry specifying the associated i-number is encountered, subtract | from delia. At 
the end, the i-number and ¢el/ta are printed if de/ta is neither 0 nor 200. The first case 
indicates that the i-node was unallocated and no entries for it appear; the second that 
it was allocated and that the linx-count and the number of directory entries agree. 
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BUGS 


Therefore (to explain the symptoms of the most common difficulties) delta = 377 (-—1 
in 8-bit, 2’s complement octal) means that there is a directory entry for an unallocated 
i-node. This is somewhat serious and the entry should be be found and removed 
forthwith. Delta = 201 usually means that a normal, allocated i-node has no directory 
entry. This difficulty is much less serious. Whatever blocks there are in the file are 
unavailable, but no further damage will occur if nothing is done. A c/ri followed by a 
check —s will restore the lost space at leisure. _ 


In general, values of delta equal to or somewhat above 0, 100, or 200 are relatively in- 
nocuous; just below these numbers there is danger of spreading infection. 


Check —/or —w on large file systems takes a great deal of core. 

Since check is inherently two-pass in nature, extraneous diagnostics may be produced 
if applied to active file systems. 

It believes even preposterous super-blocks and consequently can get core images. 
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NAME 
chown — change owner 
SYNOPSIS 


chown owner file ... 


DESCRIPTION 
The user-ID of the files is changed to owner. The owner may be either a decimal UID 
or a login name found in the password file. 


Only the owner of a file (or the super-user) is allowed to change the owner. Unless it 
is done by the super-user, the set-user-ID permission bit is turned off as the owner of 
a file is changed. 


FILES 
/etc/passwd 


SEE ALSO 
BUGS 
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NAME 


clri — clear i-node 


SYNOPSIS 


clri i-number [ filesystem ] 


DESCRIPTION 


BUGS 


Clri writes zeros on the 32 bytes occupied by the i-node numbered i-number. If the file 
system argument is given, the i-node resides on the given device, otherwise on a de- 
fault file system. The file system argument must be a special file name referring to a 
device containing a file system. After c/ri, any blocks in the affected file will show up 
as “‘missing’’ in an icheck of the file system. 


Read and write permission is required on the specified file system device. The i-node 
becomes allocatable. 


The primary purpose of this routine is to remove a file which for some reason appears 
in no directory. If it is used to zap an i-node which does appear in a directory, care 
should be taken to track down the entry and remove it. Otherwise, when the 1-node is 
reallocated to some new file, the old entry will still point to that file. At that point re- 
moving the old entry will destroy the new file. The new entry will again point to an 
unallocated i-node, so the whole cycle is likely to be repeated again and again. 


Whatever the default file system is, it is likely to be wrong. Specify the file system ex- 
plicitly. | 


If the file is open, c/ri is likely to be ineffective. 
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NAME 
crash — what io do when the system crashes 


DESCRIPTION | 
This section gives at least a few clues about how to proceed if the system crashes. It 
can’t pretend to be complete. 


How to bring it back up. If the reason for the crash is not evident (see below for gui- 
dance on ‘evident’), you may want to try to dump the system if you feel up to debug- 
ging. At the moment a dump can be taken only on magtape. With a tape mounted 
and ready on drive (, stop the machine, load address 44, and start. This should write 
a copy of all of core on the tape with an EOF mark. Caution: Any error is taken to 
mean the end of core has been reached. This means that you must be sure the ring is 
in, the tape is ready, and the tape is clean and new. If the dump fails, you can try 
again, but some of the registers will be lost. See below for what to do with the tape. 


In restarting after a crash, always bring up the system single-user. This is accom- 
plished by following the directions in boot procedures (VIII) as modified for your partic- 
ular installation; a single-user system is indicated by having a particular value in the 
switches (173030 unless you’ve changed init) as the system starts executing. When it 
is running, perform a check or icheck (VIID on all file systems which could have been 
in use at the time of the crash. If any serious file system problems are found, they 
Should be repaired. When you are satisfied with the health of your disks, check and. 
set the date if necessary, then come up multi-user. This is most easily accomplished 
by changing the single-user value in the switches to something else, then logging out 
by typing an EOT. | 


To boot UNIX at all, three files (and the directories leading to them) must be intact. 
First, the initialization program /ctc/init must be present and executable. If it is not, 
the CPU will loop in user mode at location 6. For init to work correctly, /dev/tty8 and 
/bin/sh must be present. If either does not exist, the symptom is best described as 
thrashing. /nit will go into a fork/exec loop trying to create a Shell with proper standard 
input and output. 


if you cannot get the system to boot, a runnable system must be obtained from a 
backup medium. The root file system may then be doctored as a mounted file system 
as described below. If there are any problems with the root file system, it is probably 
prudent to go to a backup system to avoid working on a mounted file system. 


Repairing disks. The first rule to keep in mind is that an addled disk should be treated 
gently; it shouldn’t be mounted unless necessary, and if it is very valuable yet in quite 
bad shape, perhaps it should be dumped before trying surgery on it. This 1s an area 
where experience and informed courage count for much. 


The problems reported bY heck typically fall into two kinds. There can be problems 
with the free list: duplicates in the free list, or free blocks also in files. These can be 
_cured easily with an icheck —s. If the same block appears in more than one file or if a 
file contains bad blocks, the files should be deleted, and the free list reconstructed. 
The best way to delete such a file is to use c/ri (VIII), tnen remove its directory en- 
tries. If any of the affected files is really precious, you can try to copy it to another 
device first. 


Icheck may report files which have more directory entries than links. Such situations 
are potentially dangerous; c/ri discusses a special case of the problem. All the directory 
entries for the file should be removed. If on the other hand there are more links than 
directory entries, there is no danger of spreading infection, but merely some disk 
space that is lost for use. It is sufficient to copy the file (if it has any entries and is 
useful); then use c/rion its inode and remove any directory entries that do exist. 
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Finally, there may be inodes reported by check or icheck that have 0 links and 0 en- 
tries. These occur on the root device when the system is stopped with pipes open, and 
on other file systems when the system stops with files that have been deleted while 
still open. A c/ri will free the inode, and an icheck -s will recover any missing blocks. 


Why did it crash? UNIX types a message on the console typewriter when it voluntari- 
ly crashes. Here is the current list of such messages, with enough information to pro- 
vide a hope at least of the remedy. The message has the form ‘panic: ...’, possibly ac- 
companied by other information. Left unstated in all cases is the possibility that 
hardware or software error produced the message in some unexpected way. 


blkdev 
The getb/k routine was called with a nonexistent major device as argument. 
Definitely hardware or software error. 


devtab 
Null device table entry for the major device used as argument to getblk. 
Definitely hardware or software error. 
iinit 
An I/O error reading the super-block for the root file system during initialization. 
out of inodes 
A mounted file system has no more i-nodes when creating a file. Sorry, the dev- 
ice isn’t available; the icheck should tell you. 


no fs 
A device has disappeared from the mounted-device table. Definitely hardware or 
software error. 


no imt 
Like ‘no fs’, but produced elsewhere. 


no inodes 
The in-core inode table is full. Try increasing NINODE in param.h. Shouldn't 
be a panic, just a uSer error. 


no clock 
During initialization, neither the line nor programmable clock was found to exist. 
Swap error 
An unrecoverable I/O error during a swap. Really shouldn’t be a panic, but it is 
hard to fix. 


unlink — iget 
The directory containing a file being deleted can’t be found. WHardware or 
software. 


out of Swap space 
A program needs to be swapped out, and there is no more swap space. It has to 
be increased. This really shouldn’t be a panic, but there is no easy fix. 


out of text 
A pure procedure program is being executed, and the table for such things is 
full. This shouldn't be a panic. 


trap 
An unexpected trap has occurred within the system. This is accompanied by 
three numbers: a ‘ka6’, which is tue contents of the segmentation register for the 
area in which the system’s stack is kept; ‘aps’, which is the location where the 
hardware stored the program status word during the trap; and a ‘trap type’ which 
encodes which trap occurred. The trap types are: 


0 bus error 
| illegal instruction 
2 BPT/trace 
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3 IOT 
4 power fail 
5 EMT 
6 recursive system call (TRAP instruction) 
7 11/70 cache parity, or programmed interrupt 


10 _—_— floating point trap 
11 segmentation violation 


In some of these cases it is possible for octal 20 to be added into the trap type; this in- 
dicates that the processor was in user mode when the trap occurred. tt you wish to 
examine the stack after such a trap, either dump the system, or use the console 
switches to examine core; the required address mapping is described below. 


Interpreting dumps. A\ll file system problems should be taken care of before attempting 
to look at dumps. The dump should be read into the file /usr/sys/core; cp. (I) will do. 
At this point, you should execute ps —alx and who to print the process table and the 
users who were on at the time of the crash. You should dump (od (I)) the first 30 
bytes of /usr/sys/core. Starting at location 4, the registers RO, Rl, R2, R3, R4, RS, SP 
and KDSA6 (KISA6 for 11/40s) are stored. If the dump had to be restarted, RO will 
not be correct. Next, take the value of KA6 (location 22(8) in the dump) multiplied 
by 100(8) and dump 1000(8) bytes starting from there. This is the per-process data 
associated with the process running at the time of the crash. Relabel the addresses 
140000 to 141776. RS is C’s frame or display pointer. Stored at (R5) is the old R5 
pointing to the previous stack frame. At (R5)+2 is the saved PC of the calling pro- 
cedure. Trace this calling chain until you obtain an R5 value of 141756, which is 
where the user’s R5 is stored. If the chain is broken, you have to look for a plausible 
RS, PC pair and continue from there. Each PC should be looked up in the system’s 
name list, using db (I) and its ‘:’ command to get a reverse calling order. In most 
cases this procedure will give an idea of what is wrong. A more complete discussion 
of system debugging is impossible here. 


SEE ALSO 
clri, icheck, check on boot procedures (VIII) 
"Explanation of Abnormal Conditions — within the UNIX — Operating 
System", MMEF,3/17/75. 


BUGS 
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NAME 
df — disk free 


SYNOPSIS 
df [ filesystem ] 


DESCRIPTION | 
Df prints out the number of free blocks available on a file system. If the file system is 
unspecified, the free space on all of the normally mounted file systems is printed. 


FILES 
/dev/rf?, /dev/rk?, /dev/rp? 


SEE ALSO 
icheck (VIII), check (VIII) 


BUGS 


ae 
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NAME 


dump — incremental file system dump 


SYNOPSIS 


DESCRI 


dump [ key [ arguments | filesystem ] 


PTION 


Dump makes an incremental file system dump on magtape of all files changed after a 
certain date. The Aey argument specifies the date and other options about the dump. 
Key consists of characters from the set abcfiuOhds. 


a Normally files larger than 1000 blocks are not incrementally dumped; this flag 
forces them to be dumped 


b The next argument is taken to be the maximum size of the dump tape in blocks 
(see s). 


C If the tape overflows, increment the last character of its name and continue on 
that drive. (Normally it asks you to change tapes.) 


f Place the dump on the next argument file instead of the tape. 


i the dump date is taken from the entry in the file /etc/dtab corresponding to the 
last time this file system was dumped with the -u option. 


u the date just prior to this dump is written on /etc/dtab upon successful comple- 
tion of this dump This file contains a date for every file system dumped with 
this option. 

0 the dump date is taken as the epoh (beginning of time). Thus this option 
causes an entire file system dump to be taken. 


the dump date is some number of hours before the current date. The number of 
houts is taken from the next argument in arguments. 


d the dump date is some number of days before the current date. The number of 
days 1s taken from the next argument in arguments. | 


S the size of the dump tape is specified in feet. The number of feet is taken from 
the next argument in ary:wnenty. |t is assumed that there are 9 standard UNIX 
records per foot. When the specified size 1s reached, the dump will wait for reels 
to be changed. The default size ts 2200 feet. 


If no arguments are given, the Ac: 1s assumed to be i and the file system is assumed 
to be /dev/rp0. 


Full dumps should be taken on quiet file systems as follows: 


dump Qu /dev/rp0 

check -! /dev/rp0 
The check will come in handy in case it is necessary to restore u.dividual files from this 
dump. Incremental dumps should then be taken when desired by: 

dump i /dev/rp0 


When the incremental dumps get cumbersome, a new complete dump should be tak- 
en. In this way. a restore requires loading of the complete dump tape and only the la- 
test incremental tape. 


DIAGNOSTICS 


If the dump requires more than one tape, it will ask you to change tapes. Reply with a 
new-line when this has been done. If the first block on the new tape is not writable, 
eg., because you forgot the write ring, vou get a chance to fix it. Generally, however, 
read or write failures are fatal. 
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FILES 
/dev/mt0 magtape 
/dev/rp0 default file system 
/etc/dtab 

SEE ALSO 


restor (VIII), check (VIII, dump (V) 
BUGS _ 
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GETTY.( VIII) GETTY (VIII) 


NAME 


getty — set typewriter mode 


SYNOPSIS 


/etc/getty [ char ] 


DESCRIPTION ~ 


Getty is invoked by init (VIII) immediately after a typewriter is opened following a 
dial-up. It reads the user’s login name and invokes the /ogin (I) command with the 
user’S name as argument. While reading the name, getty attempts to adapt the system 
to the speed and type of terminal being used. 


Init calls getty with an argument specified by the ¢tys file entry for the typewriter line. 
Arguments other than ‘0’ can be used to make gefty treat the line specially. Normally, 
it sets the speed of the interface to 300 baud, specifies that raw mode is to be used 
(break on every character), that echo is to be suppressed, and either parity allowed. It 
types the ‘‘login:’’ message, which includes the characters which put the Terminet 300 
terminal into full-duplex and return the GSI terminal to non-graphic mode. Then the 
user's name is read, a character at a time. If a null character is received, it is assumed 
to be the result of the user pushing the ‘‘break”’’ (‘‘interrupt’’) key. With the normal 
argument of ‘0’ for a given typewriter line, subsequent “‘breaks’’ will cause the type- 
writer to cycle through the three speeds from 300 to 150 tO 110 baud with the ‘‘login”’ 
typed for each occurrence. (Note that the terminal speed switch must be correspond- 
ingly set (300, 150, 110) or the typewriter output will prove incomprehensible.) If a 
aah end-of-file is received, the typewriter speed reverts to the initialized speed 
300). 


With arguments of ‘-’, ‘1’, and ‘2° the terminal speeds are set to 110, 150, and 1200 
baud, respectively. The aforementioned arguments, however, do not have the cycling 
ability that ‘0’ possesses. 


The usSer’s name is terminated by a new-line or carriage-return character. The latter 
results in the system being set to treat carriage returns appropriately (see s¢ty (II)). 


The user’s name is scanned to see if it contains any lower-case alphabetic characters; if 
not, and if the name is non-empty, the system is told to map any future upper-case 
characters into the corresponding lower-case characters. 


Finally, login is called with the user’s narne as argument. 


SEE ALSO 


BUGS 


init (VIII), login (I), stty (II), ttys (V) 
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NAME 
glob — generate command arguments 


SYNOPSIS 
/etc/glob command [ arguments ] 


DESCRIPTION 
Glob is used to expand arguments to the shell containing ‘‘*’’, ‘‘[’’, or ‘*?”’. It is 
passed the argument list containing the metacharacters; glob expands the list and calls 
the indicated command. The actions of glob are detailed in the Shell writeup. 


SEE ALSO 
sh (1) 


BUGS 
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NAME 
icheck — file system consistency check and interactive repair 


SYNOPSIS 
3 icheck [ —syn ] [ filesystem ] ... 


DESCRIPTION | 

_Icheck audits UNIX file systems for consistency and corrects any discrepancies. Since 
these corrections will, in general, result in a loss of data, the program will request 
operator concurrence for each such action. All questions should be answered by typ- 
ing "yes" or "no", followed by a new-line character. Typing "yes" will cause the correc- 
tion to take place. However, if the program does not have write permission on the file 
system or the "no" option, -n, is on, then all questions will automatically be answered 
"no". Alternatively the "yes" option, -y, will cause all questions to be answered "yes". 


The program consists of six separate phases. Some phases are skipped if they are not 
needed. In phase one, icheck examines all block pointers in all files; checking for 
pointers which are outside of the file system (BAD) and for blocks which appear in 
more than one file (DUP). A table is made of all DUP blocks and all defective files 
a marked for clearing. Each error is printed, but no correction takes place in this 
phase. 


The second phase is run only if DUP blocks were found in phase one. This phase 
finds the rest of the DUP blocks, marking each for clearing. 


The third phase checks the directory structure of the file system. This is done by des- 
cending the directory tree, examining each entry. A count is kept of the number of 
references to each file. If any entry refers to an unallocated file, a file marked for 
clearing, or a file number outside the file system, then the entry is printed, and, if the 
operator agrees, it is removed. Refusing to remove an entry to a marked file will clear 
the mark, preserving the file and its subsequent entries. 


In phase four all marked or unreferenced files are listed. With concurrence from the 
operator, each of these files is then cleared. In addition, any file whose link count 
does not agree with the number of references is listed; and, if agreed, the link count is 
adjusted. | 


If the salvage option, -s, is on, then phase five is skipped. Otherwise, check examines 
the free list. If any blocks are found which are outside the file system or which have 
been previously encountered in a file or elsewhere in the free list, then the list is pro- 
nounced BAD and a salvage is called for. Operator agreemerit will set the salvage op- 
tion and proceed to tne next phase. If there are no defects in the free list and all 
blocks are accounted for, the check is finished. Otherwisc, the number of missing 
blocks (i.e. in neither a file nor the free list) is printed and a sa!vage is requested. 


The last phase is the salvage operation; where the free list is recreated. It is run when- 
ever the salvage option is on or a problem has been found with the free list. Simply 
stated, a new free list is constructed containing all blocks not found in some file. 


The system responses are in general self-explanatory and follow the sequence 
described above. In the specification that follows, the following notation will be used: 


<b> block number 
<i> _ inode number 
<fname> file pathname 
<n> positive integer 
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<c> option character 
Icheck begins with the following output: 


< filesystem > {(NO WRITE)} 
Phase 1 - Check Blocks 


The "(NO WRITE)" message indicates that the program does not have write permis- 
sion on the file system. Therefore, subsequent corrections will be suppressed, by au- 
tomatically answering "no" to all questions. Phase one then proceeds to list any BAD 
or DUP blocks and their inode number, as follows: 


<b> BAD J=<i> 


<b< DUP I=<1> 
<b> EXCESSIVE DUPS I=<i> 


If too many DUPs are encountered, the program will list all blocks. But it will not 
mark the excess DUPs for later processing. When Phase | is finished, if any DUPs 
were encountered, then Phase 2 is run. Otherwise, Phase 2 is skipped. This phase 
will list the rest of the DUP blocks as follows: 
Phase 2 - Rescan for more DUPS 

<b> DUP [= <i> 
Check now descends the directory tree, asking to remove any defective entries. 


Phase 3 - Check Pathnames 


I OUT OF RANGE T= <i> <fname> REMOVE? 
UNALLOCATED I= <i> <fname> REMOVE? 
BAD/DUP J= <i> <fname> REMOVE? 


If no option has been specified, the program will wait for a response of “yes" or "no’ 
after each question. Note, a "no" answer to the BAD/DUP entry will unmark that 
inode for clearing. This will suppress any subsequent correction to that file. 


Now icheck will clear or adjust any defective files. Again, if no option has been 
specified, it will wait for a "yes" or "no" response to each question. The program will 
also indicate whether each entry is a file or a directory. 


Phase 4 - Check Reference Counts 


UNREFERENCED {FILE/DIRECTORY [= <i> CLEAR? 
BAD/DUP FILE/DIRECTORY I= <i> CLEAR? 
LINK COUNT FILE/DIRECTORY I= <i> ADJUST? 


If the salvage option is not on, the program will now validate the free list. Otherwise, 
this phase is skipped. If there are any errors in the free list, it will specify them and 
request a Salvage. 

Phase 5 - Check Free List 


BAD FREE LIST SALVAGE? 
<n> MISSING SALVAGE? 


Phase 6 is the salvage operation. It is only done if one has been requested. 
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Phase 6 - Salvage Free List 


Finally, some totals are printed: the total number of allocated files (including direc- 
Rage and special files); the number of blocks in use; and the number of blocks in the 
ree [ist. 


<n> FILES <n> BLOCKS <n> FREE 


If the file system has been modified, then the following message is printed and the 
program goes into a loop. This is only a reminder to the operator since the program 
can be forced to terminate with a <DEL> character. 


***** BOOT UNIX(NO SYNC!)***** 


A number of errors can terminate icheck. An illegal option or the inability to open 
the file system are shown as: 


<c> OPTION?? 
CAN NOT OPEN < filesystem > 


An I/O error on the filesystem will also cause an error message. In this case, the 
operator is given the choice of exiting ("yes") or continuing ("no"). This error is gen- 
erally a hardware error, and continuing is rarely a good idea. , 


CAN NOT READ < filesystem > BLOCK <b>EXIT? 
CAN NOT SEEK < filesystem > BLOCK <b>EXIT? 
CAN NOT WRITE < filesystem > 7 BLOCK <b>EXIT? 
/dev/rootdev default file system to be checked 


Icheck has been known to produce core images on large file systems. 
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NAME | 
init — process control initialization 
SYNOPSIS 
/etc/init 
DESCRIPTION 


FILES 


SEE ALSO 


[nit is invoked inside UNIX as the last step in the boot procedure. Generally its role is 
to create a process for each typewriter on which a user may log in. 


First, init checks to see if the console switches contain 173030. (This number is likely 
to vary between systems.) If so, the console typewriter /dev/tty8 is opened for reading 
and writing and the Shell is invoked immediately. This feature is used to bring up a 
single-user system. When the system is brought up in this way, the getty and /ogin 
routines mentioned below and described elsewhere are not used. If the Shell ter- 
minates, ‘n/t starts over looking for the console switch setting. 


Otherwise, init invokes a Shell, with input taken from the file /efc/rc. This command 
file performs housekeeping, like removing temporary files, mounting file systems, and 
Starting daemons. 


Then init reads the file /erc/ttys and forks several times to create a process for each 
typewriter specified in the file. Each of these processes opens the appropriate typewrit- 
er for reading and writing. These channels thus receive file descriptors 0 and 1, the 
Standard input and output. Opening the typewriter will usually involve a delay, since 
the open is not completed until someone is dialed up and carrier established on the 
channel. Then /etc/getty is called with argument as specified by the last character of the 
ttys file line. Gerty reads the user’s name and invokes /ogin (I) to log in the user and 
execute the Shell. 


Ultimately the Shell will terminate because of an end-of-file either typed explicitly or 
generated as a result of hanging up. The main path of init, which has been waiting for 
such an event, wakes up and removes the appropriate entry from the file wonp, which 
records current users, and makes an entry in /usr/adm/wimp, which maintains a history 
of logins and logouts. Then the appropriate typewriter is reopened and geity is rein- 
voked. 


Init catches the hangup signal (signal #1) and interprets it to mean that the switches 
should be examined as in a reboot: if they indicate a multi-user system, the /erc/itys file 
is read again. The Shell process on each line which used to be active in /fvs but is no 
longer there is terminated; a new process is created for each added line, lines un- 
changed in the file are undisturbed. Thus it is possible to drop cr add phone lines 
without rebooting the system by changing the ¢tys file and sending a Auwngup signal to 
the init process: use ‘‘kill —1 1.” 


/dev/tty?, /tmp/utmp, /usr/adm/wtmp, /etc/ttys, /etc/rc 


login (1), kill (1), sh (1), ttys (V), getty (VIII) 
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NAME 
ino — get the i-number of a file 
SYNOPSIS 
ino file ... 
DESCRIPTION 


The i-number of each file argument is printed. An i-number of zero is printed if a bad 
argument is given. | 


BUGS | 
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NAME 
ipd — line printer daemon 


SYNOPSIS 
fetc/Ipd 


DESCRIPTION 
Lpd is the line printer daemon (spool area handler) invoked by /pr. It uses the direc- 
tory /usr/lpd. The file /ock in that directory is used to prevent two daemons from 
becoming active simultaneously. After the daemon has successfully set the lock, it 
scans the directory for files beginning with “‘df.’’ Each such file is submitted as a job. 
Each line of a job file must begin with a key character to specify what to do with the 
remainder of the line. 


L specifies that the remainder of the line is to be sent as a literal. 


B specifies that the rest of the line is a file name. That file is to be sent as binary 
cards. 


F is the same as B except a form feed is prepended to the file. 


U specifies that the rest of the line is a file name. After the job has been transmit- 
ted, the file is unlinked. 


FILES 
/usr/lpd/*spool area 
/dev/lp printer 
SEE ALSO 
dpd (VIII), lpr (1) 
BUGS 


Temporary files (of the form tf.*) never get removed and must be deleted manu- 
ally. ; 
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NAME 
mkfs — construct a file system 


SYNOPSIS 
/etc/mkfs special proto 


DESCRIPTION 

Mkfs constructs a file system by writing on the special file special according to the 
directions found in the prototype file proto. The prototype file contains tokens separat- 
ed by spaces or new lines. The first token is the name of a file to be copied onto 
block zero as the bootstrap program {see boot procedures (VIII)). The second token 
is a number specifying the size of the created file system. Typically it will be the 
number of blocks on the device, perhaps diminished by space for swapping. The next 
token is the i-list size in blocks (remember there are 16 i-nodes per block). The next 
set of tokens comprise the specification for the root file. File specifications consist of 
tokens giving the mode, the user-id, the group id, and the initial contents of the file. 
The syntax of the contents field depends on the mode. 


The mode token for a file is a 6 character string. The first character specifies the type 
of the file. (The characters —bed specify regular, block special, character special and 
directory files respectively.) The second character of the type is either u or — to speci- 
fy set-user-id mode or not. The third is g or — for the set-group-id mode. The rest 
of the mode is a three digit octal number giving the owner, group, and other read, 
write, execute permissions (see chmod (I)). 


Two decimal number tckens come after the mode; they specify the user and group 
ID’s of the owner of the file. 


If the file is a regular file, the next token is a pathname from which the contents and 
size are copied. — 


If the file is a block or character special file, two decimal number tokens follow which 
give the major and minor device numbers. 


If the file is a directory, mk/s makes the entries . and .. and then reads a list of names 
and (recursively) file specifications for the entries in the directory. The scan is ter- 
minated with the token §. 


If the prototype file cannot be opened and its name consists of a string of digits, mk/s 
builds a file system with a single empty directory on it. The size of the file system is 
the value of proto interpreted as a decimal number. The i-list size is the file system 
size divided by 43 plus the size divided by 1000. (This corresponds to an average size 
of three blocks per file for a 4000 block file system and six blocks per file at 40, 000.) 
The boot program is left uninitialized. 


A sample prototype specification follows: 


/usr/mdec/uboot 

4872 55 

d——777 31 

usr d——777 3 1 
sh ———755 3 1 /bin/sh | 
ken oe 6 1 


$ 


SEE ALSO 
file system (V), directory (V), boot procedures (VIII) 
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It is not possible to initialize a file larger than 64K bytes. 


The size of the file system is restricted to 64K blocks. 
There should be some way to specify links. 
Unbalanced $’s cause unclear diagnostics. 
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NAME | 
mknod — build special file 
SYNOPSIS — . 
/etc/mknod name [ c ] [ b ] major minor 
DESCRIPTION 
Mknod makes a directory entry and ct responding i-node for a special file. The first 
argument is the name of the entry. The second is b if the special fite is Block-type 
(disks, tape) or c if it is character-type (other devices). The fast two arguments are 
numbers specifying the major device type and the minor device (e.&%., Unit, drive, or 
line number). 
The assignment of major device numbers ts eendarincd: they can Be found in the 
system source file conjf‘c. 
SEE ALSO 


mknod (II) 
BUGS 
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NAME 
mount — mount file system 


SYNOPSIS 
/etc/mount special file [ —r ] 


DESCRIPTION | 
Mount announces to the system that a removable file system is present on the device 
corresponding to special file specia/ (which must refer to a disk or possibly DECtape). The /ile 
must exist already; it becomes the name of the root of the newly mounted file system. 


Mount maintains a table of mounted devices; if invoked without an argument it prints the table. 


The optional last argument indicates that the file is to be mounted read-only. Physically write- 
protected and magnetic tape file systems must be mounted in this way or errors will occur when 
access times are updated, whether or not any explicit write is attempted. 


SEE ALSO 
mount (IJ), mtab (VII), umount (VIID 


BUGS 
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NAME 
- reloc — relocate object files 
SYNOPSIS 
reloc file octal [ — ] 
DESCRIPTION | 
Reloc modifies the named object program file so that it will operate correctly at a 
different core origin than the one for which it was assembled or loaded. 
The new core origin is the old he increased by the given octal number (or de- 
‘creased if the number has a ‘—’ sign). 
If the object file was generated by /d, the ~r and —d options must have been given to 
preserve the relocation information and define any common symbols in the file. 
If the optional last argument is given, then any sefd instruction at the start of the file 
will be replaced by a no-op. 
The purpose of this command is to simplify the preparation of object programs for sys- 
tems which have no relocation hardware. It is hard to imagine a situation in which it 
would be useful to attempt directly to execute a program treated by reloc. 
SEE ALS 


BUGS 


O 
as (I), Id (1), a.out (V) 


Bell Telephone Laboratories, Incorporated — ae PA-1C300-01 
PROGRAM APPLICATION INSTRUCTION Section 8 


Issue 1, January 1976 
AT&TCo SPCS 


RESTOR (VIII) RESTOR ( VIII) 


NAME 


restor — incremental file system restore 


SYNOPSIS 


restor key [{ arguments |] 


DESCRIPTION 


Restor is used to read magtapes dumped with the dump command. The key argument 
specifies what is to be done. Key is a character from the set trxw. 


t 


f 
i 
Ww 


The date that the tape was made and the date that was specified in the dump 
command are printed. A list of all of the irnumbers on the tape is also given. 


The tape is read and loaded into the file system specified in arguments. This 
should not be done lightly (see below). 


Each file on the tape is individually extracted into a file whose name is the file’s 
i-number. If there are arguments, they are interpreted as i-numbers and only 
they are extracted. 


If the tape overflows, increment the last character of its name and continue on 
that new drive. (Normally it asks you to change tapes.) 


Read the dump from the next argument file instead of the tape. 
All read and checksum errors are reported, but will not cause termination. 


In conjunction with the x option, before each file is extracted, its i-number is 
typed out. To extract this file, you must respond with y. 


The x option is used to retrieve individual files. If the i-number of the desired file is 
not known, it can be discovered by following the file system directory search algor- 


ithm. 


First retrieve the root directory whose i-number is 1. List this file with /s —/fi J. 


This will give names and i-numbers of sub-directories. Iterating, any file may be re- 
trieved. 


The r option should only be used to restore a complete dump tape onto a clear file 
system or to restore an incremental dump tape onto this. Thus 


/etc/mkfs /dev/rp0 40600 
restor r /dev/rp0 


is a typical sequence to restore a complete dump. Another restor can be done to get an 
incremental dump in on top of this. 


A dump followed by a mkfs and a restor is used to change the size of a file system. 


FILES 
/dev/mt0 
SEE ALSO 
Is (1), dump (VIII), mkfs (VHD), clri (VID 
DIAGNOSTICS 
There are various diagnostics involved with reading the tape and writing the disk. 
There are also diagnostics if the i-list or the free list of the file system is not large 
enough to hold the dump. 
If the dump extends over more than one tape, it may ask you to change tapes. Reply 
with a new-line when the next tape has been mounted. sO 
BUGS 


There is redundant information on the tape that could be used in case of tape reading 


problems. Unfortunately, restor’s approach ts to exit if anything is wrong. 
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NAME 


sa — Shell accounting 


SYNOPSIS 


sa [ —abcjlnrstuv } [ file ] 


DESCRIPTION 


When a user logs in, if the Shell is able to open the file /usr/adm/sh_acct, then as each command 
completes, the Shell writes at the end of this file the name of the command, the user, system 
time and real time consumed, and the user ID. Sa reports on, cleans up, and generally main- 
tains this and other accounting files. To turn accounting on and off, the accounting file must be 
created or destroyed externally. If the user is the super-user, accounting is placed into 
/usrladm/su_acct instead. As with sh_acct, it must be created or destroyed externally. 


Sa is able to condense the information in /usr/adm/sh_acct into a summary file /usr/adm/sht_acct 
which contains a count of the number of times each command was called and the time 
resources consumed. This condensation is desirable because on a large system sh_acct can grow 
by 100 blocks per day. The summary file is read before the accounting file, so the reports in- 
clude all available information. 


If a file name is given as the last argument, that file will be treated as the accounting file; 

Sh_acct is the default. There are many options: 

a Place all command names containing unprintable characters and those used only once under 
the name ‘‘***other.’ 


b Sort output by sum of user and system time divided by number of calls. Default sort is by 
sum of user and system times. 


c Besides total user time, system time, and real time for each command, print percentage of 
total time over all commands. 


Cues 


Instead of total minutes time for each category, give seconds per call. 
1 Separate system and user time; normally they are combined. 


fn Sort by number of calls. 


Reverse order of sort. 


bag 


2] 


Merge accounting file into summary file /usr/adm/sht_acct when done. 
For each command report ratio of real time to the sum of user and system times. 


u Superseding all other flags, print for each command in the accounting file the day of the 
year, time, day of the week, user ID and command name. 
v If the next character is a digit n, then type the name of each command used a times or 


fewer. Await a reply from the typewriter; if it begins with ‘‘y’’, add the command to the 
category ‘‘**junk**.’’ This is used to strip out garbage. 


FILES 
/usr/adm/sh_acct 
/usr/adm/sht_acct 
/usr/adm/su_acct 
SEE ALSO 


BUGS 


ac (VIII) 
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NAME 
su — become privileged user 


SYNOPSIS 
Su 


DESCRIPTION 
Su allows one to become the super-user, who has all sorts of marvelous (and 
correspondingly dangerous) powers. In order for su to do its magic, the user must 
supply a password. If the password is correct, su will execute the Shell with the UID 
set to that of the super-user. To restore normal UID privileges, type an end-of-file to 
the super-user Shell. 


The password demanded is that of the entry ‘‘root’’ in the system’s password file. 
To remind the super-user of his responsibilities, the Shell substitutes ‘#’ for its usual 
prompt ‘%’. 


SEE ALSO 
sh (I) 
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NAME 
sync — update the super block 
SYNOPSIS 
sync 
DESCRIPTION 


Sync executes the sync system primitive. If the system is to be stopped, sync must be 
called to insure file system integrity. See sync (II) for details. 


SEE ALSO 
sync (II) 


BUGS 
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NAME 
umount — dismount file system 


SYNOPSIS 
/etc/umount special 


DESCRIPTION 
Umount announces to the system that the removable file system previously mounted 
on special file special is to be removed. | 


SEE ALSO 
mount (VIII), umount UD, stab (V) 
FILES | 
/etc/mtab mounted device table 
DIAGNOSTICS 


Frequently, in the case of /usr, the file system is found to be busy because one of the 
Shell accounting files (/usrladmish#_< acct of t fusrladmisu_ ace!) is open for some Shell. 


BUGS 
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UPDATE (VIII) UPDATE (VII) 
NAME , 
update — periodically update the super block 
SYNOPSIS 
update 
DESCRIPTION 


Update is a program that executes the ‘sync primitive every 30. seconds.: This insures 
that the file system is fairly up to date in case of a crash. This command should not 
be executed directly, but should be executed out of the initialization shell command 
file. See sync (II) for details. ar | 


SEE ALSO 
syne (II), init (VIID 


BUGS 
With update running, if the CPU is halted just as the sync is executed, a file system can 
be damaged. This is. partially due to DEC. hardware that writes zeros when NPR re- 
quests fail. A fix would be to have sync temporarily increment the system time by at 
least 30 seconds to trigger the execution of update. This would give 30 seconds grace 
to halt the CPU. 
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WALL (VIII) WALL (VIII) 


NAME 
wall — write to all users 


SYNOPSIS 
/etc/wall 


DESCRIPTION | 7 
Wall reads its standard input until an end-of-file. It then sends this message to all 
currently logged in users preceded by ‘““Broadcast Message ...’’. It is used to warn all 


users, typically prior to shutting down the system. 


The sender should be super-user to override any protections the users may have in- 
voked. 


FILES 
/dev/tty? 


SEE ALSO 
mesg (I), write (I) 


DIAGNOSTICS | | 
‘‘Cannot send to ...”” when the open on a user’s tty file fails. 


BUGS 


> 


